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PLAN Series Manuals 


This edition of the PLAN АЁ: Server Installation and Operation 
Manual is designed t= experienced programmers who are tami- 
liar with the computers and ^rogramming systems supported by 
Nestar PLAN File Server software In particular, a knowledge of 
IBM PC DOS is usetul 


This manual assumes tha зи! network hardware has been 
installed. 


Planning for installation is discussed in the PLAN Series Physi- 
cal Planning Manual. Installing the network and bringing up the 
file server for the first time are discussed in the PLAN Series 
Quick Installation Guides and the PLAN Series Network Installa 
tion Reference Manual. 


This manual assumes that the reader has a working knowtedge 
of the network and understands the following workstation- 
oriented network manuals: 


The General Information Manual, which provides an overview 
of the networks. 


The Network Command Reference Manual, which discusses 
network hard disks: how network files are named in them; 
how files are created, deleted, and otherwise manipulated 
using network commands; and network passwords and secu- 
rity. 


The Apple Users Guides and IBM Reference Manuals, 
which provide information specific to a workstation;operating 
system environment. The /BM PC DOS Reference Manual, 
for example, discusses customized startup for the worksta- 
tion, using a secondary "backup" file server. printing on the 
network, programming on the network, and utility programs 
available at the workstation. 


The PLAN Series General Index indexes the contents of seven 
core PLAN Series manuals. 


A bibliography of PLAN Series system manuals and guides 
appears at the end of this manual. 


The objectives of this manual are two-fold: to help the system 
manager bring up the network's file servers for the first time, 
and to act as a reference manual for maintaining the file 
servers. 

The material in this document applies to Version 2.3 of the File 
Server software. Software upgrades are discussed in Appendix 
B of the PLAN Network Command Reference Manual. 

We welcome criticisms. and suggestions. Forms for reporting 
program bugs and documentation inadequacies are included at 
the back of this manual. 


Manual Conventions 


The following conventions are used throughout this manual: 
(1) The escape key is shown as <Еѕс>. 
(2) Carriage returns are shown as «Return > 


(3) Control characters are shown as -:Ctrl-, for instance, 
«Ctrl S. 


If you want to... 


Bring up the system for the first 
time 


Create a file of startup commands 
for the file server 


Back up or restore file server data 
Help a user 


who must remount a volume 


who has forgotten a password 


who needs to customize a 
workstation startup (using 
menus and profiles) 


Hook up a remote file server 
console for diagnostic purposes 


Crunch (compact) a file server 
hard disk 


Use a secondary file server 
(the Shadow) 


Allow workstation use of local 
and network printers 


see ... 


Section 2.1 


Section 2.3.1 


Section 4.2 


Section 3.0 

(Console commands) & 
Network Command 
Reference Manual, 
Chapter 5 (REMOUNT) 


Section 3.0 and 
Network Command 
Reference Manual, 
Section 2 


PLAN Series IBM PC 
DOS Reference Manual, 
Chapter 1 


Section 2.2 


Section 4.13 


PLAN Series IBM PC 
DOS Reference Manual, 
Section 2.6 


PLAN Series IBM PC 
DOS Reference Manual, 
Sections 3.3 and 3.4 





Warning 


PLAN Series equipment generates uses and can radiate radio frequency energy. If not 
installed and used in accordance with the manufacturer's instructions. it may cause interfer 
ence to radio communications lt has been tested and tound to comply with the limits for a 
Class A computing device pursuant to Subpart J of Part 15 of FCC Rules. which are 
designed to provide reasonable protection against such interference when operated in a 
commercial environment. Operation of this equipment in a residential area is likely to cause 
interference. in which case the user at his her own expense will be required to take whatever 
measures may be required to correct the interference 
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Chapter 1 


File Server Software 


1.0 Introduction 


The software components of the file server subsystem are: 


(1) Software running on the server controller that handles 
requests from users at workstations for access of shared 
hard disks. Users make their requests from within their par- 
ticular workstation operating system environments. 


(2) Software running on user workstations that issues requests 
to the file server. 


(3) "Offline" server software that aids in system maintenance. 


1.1 Distributed Software 


File server software is shipped on a hard disk (which is part of 
the file server hardware) and on a backup Partial Tape 
Dump/Restore tape (the "Partial Tape Dump: Restore" utility is 
discussed in Section 4.1). The disk is named MAIN, but can be 
renamed using the "Examine; Modify Disk Contents" utility option 
(see Section 4.8). 


The /MAIN distribution hard disk is a bootable file server disk 
containing the following file hierarchy: 


/MAIN - root directory 
/MAIN/BOOTS/... - a collection of user station boot programs 


/MAIN/SYSTEM/FILESERVER - file server, boot program, 
and utilities 


/MAIN/SYSTEM/HELP - help files 
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/MAIN/SYSTEM, ERRORS - erro: messages 


/MAIN/SYSTEM/SETPROFILE software to establish boot 
profiles for Apple // workstations 


/MAIN/SYSTEM/PROFILE/$00, .MAIN SYSTEM/PROFILE/MENU 


- default user station profiles (used by BOOT) 


/MAIN/SYSTEM/TERM.ADDSV, /MAIN/SYSTEM/TERM.VT52, 
/MAIN/SYSTEM/TERM.TVI - terminal configuration files 


/MAIN/APPLICATIONS - distributed PLANPak application 
software 


Some of these files are protected by passwords and have res- 
tricted access rights. You can determine the protection status of 
a file by using the SHOW PROTECTION command when the 
file server is running. If a password is used on a file on the disk 
as distributed by Nestar, that password is in all cases "NES- 
ТАА”. You may want to change the passwords for your installa- 
tion using the PROTECT command. 

/MAIN/BOOTS is a directory of binary files containing boot pro- 
grams for those user stations capable of booting from the net- 
work (Apple //, IBM PC). The boot program is described in the 
appendix of the appropriate user's guide. 


/MAIN/SYSTEM/FILESERVER is the virtual volume that the file 
server boots from; it contains the file server program and file 
server utilities used to maintain the file system. 


/MAIN/SYSTEM contains: 


ERRORS 
— the text for all the error messages. 


HELP 
— a directory of files containing the text for the HELP command. 
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SETPROFILE 

— software that allows the user to create a profile for a particular 
Apple // workstation. For more information, see Chapter 4 of 
the PLAN File Server User's Guides for the Apple // environ- 
ments. 


PROFILE/$00 

— the default Apple ;; user station profile for BOOT. For more 
information, see Chapter 4 of the PLAN File Server User's 
Guides for the Apple // environments. 


PROFILE/MENU 

— the default IBM PC user station profile for BOOT. For more 
information, see Chapter 1 of the PLAN File Server Reference 
Manuals for the IBM PC environments. 


FSCMD 

— a list of file server commands that are executed when the file 
server is powered on. You can specify which commands are 
to reside in this file, as explained in Section 2.3.1. This is not 
a distributed file. 


TERM.xxx 
— configuration files for customizing the file server software to 
various terminal types. 


To verify the presence of these pathnames on your disk, issue a 
LIST command once the file server has been booted (see PLAN 
Series Network Command Reference Manual, Chapter 5, for a 
discussion of LIST). 


Chapter 2 


File Server Startup 


2.0 Introduction 


This chapter discusses: 


2.1 File Server Startup 21 
2.1.4 Inserting Tape Cartridges 2-2 
2.2 Accessing the File Server with a Console 

or Terminal (Local or Remote) 2-2 
2.2.1 Using an IBM PC as the File Server 

Console. Local or Remote 2-4 
2.2.2 Using a Remote Console for Diagnostic 

Purposes 2-4 
2.3 Powering On the File Server 2-6 
2.3.1 Startup Commands for the File Server 

МАІМ SYSTEM/FSCMD 2-9 
2.4 System Console Passwords 2-9 
2.5 The Console Display 2-11 
2.6 Testing the System 2-11 
2.6.1 Testing the File Server 2-11 
2.6.2 Testing User Stations 2-12 
2.7 Backing Up the System 2-12 
2.8 Bringing Down the File Server 2-13 
2.9 Using a Shadow (Backup) File Server 2-13 


2.1 File Server Startup 


File server software is found on the primary hard disk when the 
system hardware is installed. The file server subsystem includes 
a high speed cartridge tape drive and several utility programs 
that are used to back up the hard disks. A backup tape contain- 
ing file server software is also distributed with the system. 


System hardware should be installed as described in the PLAN 


Series Quick Installation Guides and the Network Installation 
Reference Manual. For the file servers initial startup, 
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connection to the rest of the network should be disabled. For the 
PLAN 4000 model, disconnect the coaxial cable at the bottom of 
the back panel labeled NETWORK. This cable may run to an 
outside HUB or to a connector on one of the internal HUB 
boards. For the PLAN 3000 File Server, disconnect the coaxial 
cable from the connector labeled NETWORK on the back of the 
cabinet. 


2.1.1 Inserting Tape Cartridges 


In the PLAN 4000 File Server, tape cartridges are inserted in a 
straightforward way. However, some care is required when 
inserting and removing PLAN 3000 File Server tape cartridges. 


Insert the PLAN 3000 cartridge metal-side down, label-side up, 
with the tape and drive wheel to the left. The cartridge must be 
inserted firmly or it will not lock in place. If it is oriented 
incorrectly when inserted it will not lock in place. 


To remove the tape, press in firmly to unlock the cartridge. Pull 
out carefully to avoid damage to the tape. 


2.2 Accessing the File Server with a Console or 
Terminal (Local or Remote) 


Instructions for connecting a console or terminal to the file 
server or connecting modems for remote use are found in the 
PLAN Series Quick Installation Guides and the Network Installa- 
tion Reference Manual. 


Although any ASCII terminal capable of communicating at 9600 
baud can be used as a console, those that are screen control 
compatible with DEC VT52 or Televideo terminals will produce 
the most readable output. Three system volumes are supplied 
that allow the server to be customized to one of these terminals: 


//SYSTEM/TERM.ADDSV 


//SYSTEM/TERM.VT52 
/SYSTEM/TERM.TVI 
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If the appropriate volume is renamed to //SYSTEM/TERMINAL, 
the file server software can send the proper control sequences 
to the console. If no //SYSTEM/TERMINAL file exists on the file 
server disk, the file server software will assume that an ADDS 
Viewpoint terminal is connected. 


Note that other terminals, which are either VT52 or Televideo 
compatible, although not officially supported, may also work 
correctly. 


Before attaching your terminal to the file server, follow the termi- 
nal manufacturer's instructions to set it up as follows: 


TRANSMIT DATA RATE 9600 
RECEIVE DATA RATE 9600 
STOP BITS 1 
PARITY ENABLE ON 
PARITY SENSE EVEN 
DATA LENGTH 7 
DUPLEX FULL 
EOM CHAR CR 
XON/OFF ON 
AUTO LF/CR OFF 


Note: If a DEC VT100 Series terminal is used in VT52 mode, 
disable XON/XOFF. 


Examples: 


ADDS Viewpoint switch settings 


$1 3 5 7 8 up 
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Esprit Il switch settings 


$1 6 9 10 ир 

t 2 3 4 5 7 8 down 
S2 g^ 4 9 up 

liz 2 5-6. 7.8 10 down 


2.2.1 Using an IBM PC as the File Server Console, Local 
or Remote 


.(1) Install a serial card in the IBM PC. 


(2) For local use, cable the file server to the IBM PC using the 
file server RS232 port labeled CONSOLE and the jack on 
the serial card. For remote use, cable the IBM PC to a 
modem via the jack on the serial card. 


(3) Run a terminal emulator program in the IBM PC. Set emu- 
lator program parameters as shown in the table of switch 
settings above. 


2.2.2 Using a Remote Console for Diagnostic Purposes 


A Bell 212A compatible modem must be connected to the file 
server when a remote terminal is to be used as a console. Nes- 
tar recommends the use of a Hayes Smartmodem 1200 for this 
purpose. See MODEM ON/OFF (Sections 3.1 and 4.11) for 
more on modem use with the file server. 


If the Hayes Smartmodem 1200 is used at the local file server 
(the call will be initiated there), set the modem switches as fol- 
lows: 


2 7 up 
1 3 4 5 6 8 down 


STARTUP 


If the call is to be initiated at the remote end, switch 5 must be 
up. 


If a Hayes Smartmodem 1200 is used with a remote terminal, 
the switches should be: 


2 4 5 7 up 
1 3 6 8 down 


For other modems, set the switches up for 


1200 bps xmit/rcv speed 

full duplex 

DTR not supplied by file server 
DCD always active 


If the modem is to be used at the local file server and has auto- 
answer capability, this function should normally be disabled. 


Remote diagnosis should always be done in consultation with 
the Nestar Customer Technical Support department; contact 
your support représentative before attempting this procedure. 
To establish a remote diagnostic session, the following pro- 
cedures will normally have to be performed: 


(1) Contact your customer support representative to coordinate 
both ends. 


(2) Quit the file server at the local console and choose menu 
option "1," MODEM ON/OFF/SETUP, to enable the modem 
and to issue any setup commands to the modem. The 
modem command may be issued by a line in the FSCMD 
file (Section 2.3.1). For a Hayes Smartmodem 1200, these 
commands are (uppercase is mandatory): 


ATX1 «cr» 
(Responded to with an "OK".) 


ATD9999999 <сг> 
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(Modem will dial, audibly if speaker is turned up. When con- 
nection is made, the message "CONNECT 1200" should be 
displayed.) 


Type an <Esc> to exit the modem setup mode. 
If no file server console is present or operating, enter 


MODEM ON into an FSCMD file from a user workstation as 
described in Section 2.3.1. 


(3) Communications with the remote console should be esta- 


blished at this point. Note that any characters typed on 
either the local or remote console will be displayed at both 
In order to avoid garbled characters, do not type on the 
local console unless instructed to do so by your customer 
support representative. 


(4) At the end of the remote diagnostic session, communications 
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are normally severed by choosing menu option "1" again 
(MODEM ON/OFF SETUP) and disabling the modem. 


Powering On the File Server 


To power on the file server: 


(1) Plug in the file server. 


(2a) PLAN 4000 File Server: 
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Before powering on the file server make sure that the hard 
disks have been unlocked and that all other system installa- 
tion procedures have been completed. These procedures 
are described in the PLAN Series Network Installation 
Reference Manual. 


To power on, turn the key at the bottom front of the cabinet 
labeled FILE SERVER clockwise (to a horizontal position), 
press in, and turn back (to vertical position). This locks the 
power switch in the ON position. 


STARTUP 


Two keys are shipped with the system. The file server can- 
not be turned on without a key so make Md c as 
needed, keeping one in a safe place. 


(2b) PLAN 3000 File Server: 


Power on the file server using the power switch on the rear 
of the cabinet. 


The hard disk does not require unlocking. 


(3) At power on check to see that the fans in the file server 
cabinet and storage cabinets, if any, are operating. 


Do not operate any file server with any part of its casing 
removed. High voltages are present within. In addition, 
the PLAN 3000 File Server fan will not cool the unit properly 
with the top cover removed. 


(4) Check the power indicator light on the front panel. If the light 
flickers or goes out, contact your service representative. 


(5) At power оп a welcome banner appears. You will be given 
an opportunity at power on (5 seconds) to press the 
«Esc» key on your file server console or terminal. If 
<Esc> is not pressed, all further software will be executed 
using the default system hard disk. If <Esc> is pressed, 
the following boot menu will appear: 


T = Boot from tape drive 
1 = Boot from drive 1 

2 — Boot from drive 2 

3 — Boot from drive 3 

4 — Boot from drive 4 
Which drive? 


At this point you must enter the character for the unit you 
wish to boot from. 


(6) The hard disk drives have a warm-up period of about one 
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minute before which they will not respond to disk accesses. 
To avoid this wait, we recommend that the hard disks be 
left on at all times except when they are moved. 


If any errors are encountered during the disk portion of the boot 
process, you will see error messages with codes displayed on 
your monitor at the bottom of the screen. See Appendix A for a 
description of error codes. 


Next, you will be given 10 seconds to press the <Esc> key. If 
the <Esc> key is not pressed, the file server software will exe- 
cute. If the <Езс> key is pressed, a menu of network utilities 
will be displayed (see Chapter 4). Do not press the <Esc> key. 
The file server program will now execute. 


When the file server program starts up, it looks for and executes 
any console commands that you may have placed in 
/MAIN/SYSTEM/FSCMD. Console commands are discussed in 
Chapter 3 of this manual. FSCMD is discussed in Section 2.3.1. 


To set the date on the clock/calendar card, use the SET TIME 
console command described in Chapter 4. 


Unless specified in FSCMD, the file server does not ask for a 
console password when booting; the default is that no console 
password is necessary. Use the PASSWORD console com- 
mand to set or change the console password (see Section 2.4). 


Unless specified in FSCMD, the file server console display will 
be off. Use the console DISPLAY command discussed in Sec- 
tion 2.5 to turn on the console display. The system console will 
then display file server commands being processed. 


Unless specified in FSCMD, the file server network configuration 


display and audible alarm will be enabled. Use the console 
DISPLAY RECON command to turn this feature off. 


2-8 


STARTUP 


2.3.1 Startup Commands in MAIN/SYSTEM/FSCMD 


Any file server console commands found in the type- T text 
volume ;MAIN/SYSTEM/FSCMD (volume types are discussed in 
the File Server Users Manual) are executed when the file 
server program starts up. To place console commands in 
FSCMD for use at startup, use a text editor at a user worksta- 
tion to enter the desired console commands, one per line, into a 
text file in that environment. You must choose an environment 
that supports the TCOPY utility program (Apple // Pascal, IBM 
PC, or Apple ///). 


If there is a pre-existing text volume /MAIN/SYSTEM FSCMD, 
use TCOPY to bring its contents into a local file, adding new 
commands to it using the local editor. Then use TCOPY to 
transfer the file of commands to /MAIN/SYSTEM:;FSCMD 
TCOPY is discussed in Chapter 4, “Additional Utilities”. of all 
user guides for user environments that support TCOPY. 


2.4 System Console Passwords 


A console password can be set to prevent unauthorized users 
from issuing console commands to the file server. 


When a console password has been set, it must be entered 
before each console command. The console password and con- 
sole commands are entered in the following sequence: 


— press the <Esc> key 

— type the exact console password 

— press <Return> 

— type the console command and <Return> 


If the password sequence is entered incorrectly, it can be res- 
tarted by pressing the <Esc> key. Until a valid password is 
entered using the above procedure, the file server will not 
accept console commands and will continue to service network 
requests. The password entered does not show on the console 
display. 
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To set a password at startup or at any time during operation, 
use the console command PASSWORD. By using this com- 
mand, console passwords can be set, disabled, or changed 
without stopping the file server. To set the console password, 
enter 


PASSWORD PPPPP «Return > 
where PPPPP is the desired password (up to 16 characters). 
The PASSWORD command is protected with the current pass- 
word if one is in effect. 
When 

PASSWORD password < Return> 
is entered, the password will remain displayed. This will allow 
the system manager to confirm that the password has been 
entered correctly. To clear the screen, the password must be 
employed by entering 


«Esc» password Return CLEAR «Return 


That is, enter the current password, followed by a CLEAR com- 
mand. 


To turn off console password protection, enter 

«Esc» password« Return PASSWORD <Return> 
If the console display is on (see initialization above and 
DISPLAY console command below), the system console screen 
displays the most recently executed file server command and its 


return code and message: 


пп--> Network Command 
nn <-- rr,return message 


where nn is the station number of the station that originated the 
command. 
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The console display can be reinitialized by entering the console 
command CLEAR. 


The system console can also be used as a network station to 
enter file server commands. In general all of the commands that 
are available to ordinary network stations may be entered at the 
system console. There is also a set of privileged commands 
which are only accepted at the system console (discussed 
below). 


The format and details of ИО errors that can occur at the system 
console are presented in Appendix A. 


2.5 The Console Display 


While the file server software is running, the console will display: 


(1) A chronological list of commands to the file server together 
with file server response codes and messages if the 
DISPLAY ON command (Chapter 3) has been issued. 


(2) A "D" if the file server has waited more than .5 seconds for 
disk response. If the "D" appears on the screen frequently, 
or for more than one second, disk problems are indicated. 
Contact your service representative. 


(3) Print Server Feature Card Activity. If the optional Print 
Server Feature Card is present in the file server, you can 
toggle between the print server screen and the file server 
screen. For more information, refer to the Easy Guide to 
the Print Server Feature Card. 


STARTUP 


2.6 Testing the System 
2.6.1 Testing the File Server 


Before running the file server, check for errors in installation and 
configuration of the file server by bringing up the file server with 
no other stations connected to it. Once the file server is operat- 
ing correctly, user stations should be added to the network one 
by one, after connecting the file server to an active HUB. 


2.6.2 Testing User Stations 


Turn on a user station and verify that the Nestar logo appears 
on the user station screen (if the station uses the network 
BOOT program), or that the station attaches to the network 
when booted (if the station boots from a local diskette). 


Stations that boot from the network can boot using the shared 
library volume. For others, prepare a boot diskette containing 
the necessary network drivers (see environment appendices in 
this manual) and boot the workstatiori using it. 


On the active HUB to which the user station is attached, the 
light-emitting diode (LED) corresponding to. the user station will 
come on and stay on if the connection is successful. (Whenever 
the HUB sees a workstation is powered on, it turns on the LED. 
The LED has a timeout that keeps it on for .5 second each time 
that it is turned on. A new workstation on the net jams the net 
for .2 second; you will then see the LED on for .5 second. The 
net then reconfigures, which takes .8 seconds or so; here, the 
LED is off for .3 second. Finally, the LED comes on and stays 
on.) 


Confirmation of communication with the network is seen if the 
boot process takes place successfully (i.e., if the workstation 
doesn't suspend activities during booting). 


If network communication is not successful, make sure that the 


network card in the user station is in the appropriate slot and 
has a valid address. Connect all user station microcomputers in 
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this way, one by one, confirming with each that it is attached to 

the network. 

2.7 Backing Up the System 

А backup tape of system software is distributed with the system. 

For future backups, see the "Full Tape Dump/Restore" utility 

option in Chapter 4. 

2.8 Bringing Down the File Server 

To bring down the file server: 

(1) Type 

«Esc» « password- « Return 
and then QUIT «Return». 

(2) For the PLAN 4000 File Server, power off the hard disks by 
running the "Power Down Disk Drive(s)" option of the utility 
menu; this will cause the disk heads to be retracted. (For 
the PLAN 3000, this step is not necessary.) 

(3) Turn off the power by turning the key on the front of the 
cabinet clockwise. 


2.9 Using the Shadow ТМ File Server 


Use of the Shadow file server is documented in Chapter 2 of the 
PLAN Series IBM PC DOS Reference Manual. 
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3.0 System Console Commands 


А! Network Commands (CREATE, DELETE, etc.) except 
BSAVE, BLOAD, BRUN and OFF can be used at the system 
console. 


Privileged commands used only at the system console are: 


CLEAR 

DISPLAY ON/OFF 
DISPLAY RECON ON/OFF 
MODEM ON/OFF 
QUIT 

PASSWORD 

SET TIME 

SHOW ALL MOUNTS 
SUPER cmd 
TERMINAL 

$nn cmd 


Enter commands at the system console, preceded by the con- 
sole password if one has been set. No prompt or cursor will 
appear, however, until after the first character has been typed. 
Then the prompt: 


CMD> 


will appear on the console screen, followed by the character you 
just typed. Finish typing in the command and follow it by 
<Return>. The command will execute and print any error code 
or error message on the screen. 


All privileged commands can be used in the FSCMD volume 
except SET TIME. 


CONSOLE COMMANDS 

Press «Del to erase a mistyped command. Retype your 
command correctly. 

The console includes a 64-character typeahead buffer. 

To stop screen scrolling, press <Ctrl>-S. To start scrolling 
again, press = Ctrl --Q. Other methods used to stop scrolling 
with your terminal.keyboard may or may not work correctly and 
should not be used. 

Network activity ceases while console commands are being 
typed in and processed. However, if you take more than three 
seconds to enter a keystroke, network activity will resume 
automatically until your next keystroke. 


3.1 Privileged Console Commands 


This section describes the privileged console commands. 
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CLEAR 


CLEAR 


Clear system console display. 


Parameters and Defaults 


None. 


Error Messages 


None. 


Discussion 


CLEAR rewrites the system console screen with blanks 
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DISPLAY ON/OFF 


Turns the console network traffic display on or off. 


Parameters and Defaults 


The keyword ON or OFF; default is OFF. 


Error Messages 


None. 


Discussion 


The console display is used to show current command activity 
being handled by the file server. This display is turned on by 
entering DISPLAY ON and turned off by typing DISPLAY 
OFF. The default at startup is DISPLAY OFF. 


Note that having the console display enabled (DISPLAY ON) 


has some effect on system performance. The file server will 
run faster if the display is off. 
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DISPLAY RECON ON/OFF 


Turns the lower right-hand display of network reconfiguration 
activity ("~ beep--R") on or off. 


Parameters and Defaults 


The keyword ON or OFF. 
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MODEM ОМ/ОЕЕ 


МООЕМ ОМ/ОЕЕ 
Allows the file server program, file server console commands, 
and file server utilities to be used from a remote location 
Parameters and Defaults 
The keyword ON or OFF. No default; either ON or OFF must 
be typed. 
Error Messages 


None. 


Discussion 


See Section 2.2 for setting up the modem and Section 4.11 
for modem use when the file server is not running. 


If no file server console is present, enter the command from 
an FSCMD file created at a user workstation (see Section 
2.3.1). 


QUIT 


QUIT 


Quit the file server. 


Parameters and Defaults 


None. 


Error Messages 


None. 


Discussion 


QUIT instructs the file server to halt operation. All user 
volumes currently mounted are unmounted. Hence, this com- 
mand should only be used when the system is to be shut 
down. A menu of disk utilities will then be presented. 


To bring down the system completely, select the "Power 
Down Disk Drive(s)" option of the utility menu and power 
down any hard disks present. Complete power down is not 
necessary unless the system is to be moved. 


Warning: п some cases, powering down the file server 


without using QUIT will cause data being sent to the hard 
disks to be lost. 
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PASSWORD [pw] 


Sets console password. 


Parameters and Defaults 


Default is no password. Passwords can contain 1-15 charac- 
ters; no commas, slashes, colons, carriage returns, or control 
numerics. All other characters, including embedded blanks 
and control characters, are allowed. 


Error Messages 


None. 


Discussion 


The console password can be set, disabled, or changed by 
using the console command PASSWORD. To Set the console 
password, enter PASSWORD ppppp where ppppp is the 
desired password. Console commands are then not allowed 
unless the console password is entered.. The password com- 
mand itself is protected with the current password if one is in 
effect. 


Warning: There is no way to change or override the console 
password once it is enabled except by entering that password 
followed by the PASSWORD command. If the console pass- 
word is forgotten, the remedy is to restart the file server by 
powering it off and back on again. 


To use the console password to enter a console command: 
— press the <Esc> key 
— type the exact console password 


— press «Return- 
— type the console command and <Return> 
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PASSWORD 


If the password sequence is entered incorrectly, it may be 
restarted by pressing the <Esc> key. Until a valid password 
is entered by the above procedure, the file server will not 
accept console commands and will continue to service net- 
work requests. The password being entered is not shown on 
the console display. To turn off console password protection, 
enter PASSWORD <return>. 


When 

PASSWORD password «return 
is entered, the password will remain displayed. This will allow 
the system manager to confirm that the password has been 
entered correctly. To clear the screen, enter a null command. 


The password must be used; enter 


<Esc> password «Return» CLEAR « Return > 
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SET TIME [yymmdd][.hh[mm]] 


Set the clock calendar (24 hour clock). 


Parameters and Defaults 


First parameter (optional) is year/month/day. Day of the week 
is automatically calculated by the file server. 


Second parameter is the hour of the day with an optional 
minute of the hour. 


The comma must appear before the "hh" if that parameter 
appears. 


There is no default. A SET TIME without parameters is a null 
command. 
Error Messages 


58,USE: SET TIME [YYMMDD][,HH[MM]] 


Discussion 
This command can be entered at the local console, at a 
remote console via modem, or, if a console password has 
been set, at a user station. The values in brackets are 
optional (year,month,day,hour,minutes). 


If the date is to be set, all elements must be supplied. All two 
digit parameters must contain a leading zero if appropriate. 


Example: 
SET TIME 820704,1205 


sets the time to July 4, 1982, 12:05 PM. 
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ЗЕТ ИМЕ 
SET TIME ,15 


sets the hour to 3 p.m. without changing the date or minutes 
(useful for Daylight Savings Time changes). 
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SHOW ALL MOUNTS 


SHOW ALL MOUNTS [pathname] 


Display all mounts of all stations using this file server. 


Parameters and Defaults 


Optional parameter "pathname". 


Error Messages 


None. 


Discussion 


This command displays the same information as SHOW 
MOUNTS but does so for the system as a whole. All current 
mounts on the file server are displayed. 


This command may cause many lines of display to be written. 
If the final state of the screen is unsatisfactory, the CLEAR 
command can be used to clean it up. 


If the optional pathname parameter is given, only mounts of 
the corresponding volume are shown. 
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SHOW ALL MOUNTS 


Examples: 
SHOW ALL MOUNTS 
NAME DRV ACCESS T VOL SIZE 


/MAIN/LIB/APPLE2/UCSD/PASCAL 

5 ROSHR P о 280B 
/MAIN/USERS/ME 

4 RW,EXC D 32 4555 
‘MAIN/STUFF 

27 RW,SHR D о 455$ 
MAIN'/LIB/APPLE2 UCSD/PASCAL 

9 ROSHR P о 280B 


STN USE 
02 2 
41 1 
41 1 
03 2 


SHOW ALL MOUNTS /MAIN/LIB/APPLE2/UCSD/PASCAL 


NAME DRV ACCESS T VOL SIZE STN USE 


'MAIN/LIB/APPLE2/UCSD/PASCAL 


5 RO Р: 9 2200B 0? 3 
/MAIN/LIB/APPLE2/UCSD/PASCAL 

5 RO P о 2200B 41 3 
/MAIN/LIB/APPLE2/UCSD/PASCAL 

5 RO P O0 2200B 34 3 
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SUPER cmd 


SUPER cmd 


Overrides file server passwords on network files. 


Parameters and Defaults 


None. 


Error Messages 


None. 


Discussion 


The prefix SUPER can be used with console commands to 
override file server passwords on file server files. The scope 
of the SUPER prefix is limited to the command entered on the 
same line. All password protection on files is overridden dur- 
ing a SUPER command. This may be useful for changing for- 
gotten file passwords, etc. The console password should be 
set in environments where SUPER might be misused. 


The station number ($nn) and super prefixes can be used 
together in a console command if the station number prefix is 
entered first, e.g., $nn SUPER cmd. 


The SUPER prefix has no effect on the console password; it 
applies only to passwords on file system volumes. 


SUPER will not work for PROTECT when applied to an Exe- 
cute Only volume. 


TERMINAL 


TERMINAL xxxx 


Changes terminal type of the file server console to one of the 
following: 


xxxx - ADDSV (Adds Viewpoint) 


VT52 (DEC VT52) 
TVI (Televideo 920) 


This performs the same function (for the file server software) 
as /MAIN/SYSTEM/TERMINAL. It will not, however, work for 
any other utilities. It is recommended that the file server's ter- 
minal type be set with 

/MAIN;SYSTEM/TERMINAL 


rather than with this command. 


Defaults 


ADDSV (if no parameter or a parameter other than the 
allowed list is typed). 


$NN COMMAND 


$NN COMMAND 


Execute a command for a network user station. 


Parameters and Defaults 


NN is the station number to be simulated (must be between 
$1 and $FF). The number must be entered in hex preceded 
Буа "$". 


Error Messages 


1,ILLEGAL COMMAND 5,ILLEGAL STATION NUMBER 


Discussion 


The $NN COMMAND allows the system console to simulate 
network requests of other network stations. This causes the 
file server to execute the entered command as if it had been 
sent over the network from station "nn". This command 
should be used very carefully since its use may affect the 
operation of a user station in ways that the user does not 
expect. The commands BLOAD, BSAVE, BRUN, and OFF 
cannot be simulated using this command. 


The station number and super prefixes can be used together 
in a console command if the station number prefix is entered 
first, e.g., ФММ SUPER COMMAND. 


Warning: № a volume is mounted or unmounted at the con- 
sole for a particular station, only Apple // operating systems 
will recognize that the volume has been mounted or 
unmounted. 


$ММ СОММАМО 


Examples: 


This command is helpful if a user is running an editor and dis- 
covers that there is not enough room to write out the file being 
edited. The system manager can enter the following on the 
system console: 


$03 MOUNT /MAIN/EMPTYDISK,D9,RW 


where $03 in this example is the user's station number. The 
file could then be written out to EMPTYDISK. 


Similarily, ФММ COMMAND is useful for unlocking locks held 
by stations that have caused a deadlock, mounting a virtual 
disk SHaRed rather than EXClusive, etc. 


Chapter 4 


Utilities 


4.0 File Server Disk Utility Programs 


This chapter describes the file server utilities provided with the 
file server to maintain the file system and file server resources. 


These utilities run on the file server via the file server console or 
terminal and аге located on the virtual volume 
/MAIN/SYSTEM/FILESERVER. They cannot be run while other 
file server operations are in progress. 


On-line network utilities, which are run from user stations while 
the file server is in operation, are described in Chapter 4 of each 
PLAN File Server User's Guide. 


To use a utility, power on the file server. The file server network 
software waits 5 seconds before attempting to boot from the first 
disk drive. If you want to boot from unit 1, press no keys at this 
point (wait for the utility menu to appear). Otherwise, press 
«<Esc> and the boot menu will appear: 


Boot Menu 


T - Boot from tape drive 
1 - Boot from drive 1 
2 - Boot from drive 2 
3 - Boot from drive 3 
4 - Boot from drive 4 


This menu will also appear if an error is encountered during the 
subsequent boot process. 


Select the unit from which you wish to boot. (You will use utili- 
ties from tape or from a disk other than the boot disk when, for 
example, the default boot disk is to be examined for damaged 
areas.) 
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UTILITIES 


The file server waits 10 seconds before executing the file server 
software. To use a utility, type <Esc> during this waiting 
period. A menu of utilities will come up on the screen. 


If the file server software is already running, type 
[: Esc -= password: - Return ]QUIT « Return 


to quit the program, and. after you have been asked if you are 
sure you want to quit, the utility menu will come up (brackets 
indicate optional password has been set). 


On the PLAN 3000 File Server, the utility menu is as follows 
File Server Utility Menu 


(a) file server 

(b) partial tape dump: restore 

(c) reserved for future use 

(d) copy partial disk to disk 

(e) copy full disk to disk 

(f) power down disk drive(s) 

(g) list disk contents 

(h) examine/modify disk contents 
(i)  check/repair disk consistency 
(j) format disk 

(k) add or modify tape dump instruction files 
(I) modem on/off/setup 


On the PLAN 4000 and 5000 utility menu the options are the 
same except there is an additional option, full tape 
dump;restore. which appears as option L: 


(1) full tape дитр. гезюге 
(m) modem оп, ой; зешр 


Make your selection by typing the appropriate letter, followed by 
< Return». 


(a) FILE SERVER causes the file server software to execute. 
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(b) 


(c) 


UTILITIES 


PARTIAL ТАРЕ DUMP’RESTORE (Section 4.1, followed by 
ADD or MODIFY TAPE DUMP INSTRUCTION FILES. Sec- 
tion 4.2) copies selected hard disk files to and from backup 
tape cartridges Note: The tapes used by this utility are 
incompatible with those used by the Full Tape 
Dump:Restore utility option. This option is used to make 
full disk backups, as well as partial backups. 


This option is reserved for future use. 


COPY PARTIAL DISK TO DISK (Section 4.3) copies data 
from one disk location to another. Structural changes in the 
file server hierarchy can be accomplished using this utility. 


COPY FULL DISK TO DISK (Section 4.4) copies entire 
volumes of data between media that are of identical size. 


POWER DOWN DISK DRIVE(S) (Section 4.5) sequences 
down hard disks prior to turning off the disks. 


LIST DISK CONTENTS (Section 4.6) creates a list of some 
or all of the volumes on disks attached to a file server. 


EXAMINE/MODIFY DISK CONTENTS (Section 4.7) is used 
for a variety of disk maintenance and diagnostic purposes. 


CHECK/REPAIR DISK CONSISTENCY (Section 4.8) veri- 
fies the consistency of the disk data structures and option- 
ally repairs the data structures. 


FORMAT DISK (Section 4.9) initializes disks for use with 
the file server. Hard disks are shipped already formatted 
and should not be reformatted except under special cir- 
cumstances. Do not reformat a disk without first con- 
tacting your network service representative. 


ADD OR MODIFY TAPE DUMP INSTRUCTION FILES 
(Section 4.2, following PARTIAL TAPE DUMP/RESTORE, 
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UTILITIES 


Section 4.1) allows you to predefine Partial Tape 
Dump/Restore operations used in option B. 


(I) or (m) MODEM ON/OFF/SETUP (Section 4.10) allows 
you to use a modem and remote console fo file server 
diagnostics via telephone (see also MODEM ON OFF 
Chapter 3). 


( FULL TAPE DUMP RESTORE (Section 4.11), distributed 
on backup tape for the PLAN 4000 and 5000 File Servers, 
copies all the files on a hard disk onto backup tape car- 
tridges, and restores all copied files from tape to disk. 


Note: The tapes used by this utility are incompatible with 
those used by utility option B. This option is not as flexible 
as option B (Partial Tape Витр/Везюге); option B is used 
to make full disk backups. Full Tape/Restore is not avail- 
able in the PLAN 3000 File Server. 


Remember: Record any error codes and messages received 
when using network utilities (or the file server software). These 
will be important should you need to contact your network ser- 
vice representative. 


Other on-line utilities are available in various workstation 
environments. These utilities, which run on the network, are 
documented in the appropriate PLAN File Server User's Guides 
and Reference Manuals and provide services such as network 
reconfiguration counting, copying files between environments, 
and deletion of trees and subtrees of files. 


Crunching (compacting) a hard disk is described in Section 
4.12. 
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PARTIAL TAPE DUMP/RESTORE 


4.1 Partial Tape Dump/Restore 


This utility is used to create backups of network hard disks on 
the cartridges and to restore that data to the hard disks. The 
program is also used (sometimes in conjunction with other utili- 
ties) to recover from hard disk crashes. 


This option transfers a binary image of the desired data from 
tape to disk (or vice versa). This menu option can: 


a. save virtual volumes onto tape according to how recently 
they have been modified. 

b. purge virtual volumes from the disk according to how 
recently they have been accessed (for read or write). 

с save only selected virtual volumes. 

d. save virtual volumes under specific directories. 

e restore only selected virtual volumes. 

f. restore virtual volumes under specific directories. 


(c. through f. give the same capability for disk to tape transfers 
that the Copy Partial Disk to Disk utility gives.) 


Because of this option's flexibility, it can be used in a variety of 
ways. This section describes the uses of the option in typical 
situations. When you can use Full Tape Dump/Restore (Section 
4.11) as an alternative, we also describe any advantages of the 
Partial Tape Dump/Restore compared to Full Tape 
Dump/Restore. 


In general, Full Tape Dump is much faster in transferring a 
whole disk, while Partial Tape Dump allows restoration of indivi- 
dual volumes. 


Because of its flexibility, this option will often be used to make 
full disk backups, in spite of its "partial" name. 


Tapes made with Partial Tape Dump are not compatible with 
Full Tape Dump tapes. 


Backup strategy and tactics are discussed in Section 4.1.4. 
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To set up defaults and predefined ("canned") operations, see 
Sections 4.1.2.1, 4.1.5. and 4.2. Predefined operations that are 
immediately available with the utility (Section 4.1.5) include: 


#1 Daily Backup 

#2 Archive and Purge 
#3 Software Distribution 
#4 Volume Interchange 
#5 Complete Save 


The following introductory pages discuss when to use the Partial 
Dump Restore option: 


a. Tape Cartridges and the Tape Drive 4-7 
b. Daily Backups 4-14 
c. Archive and Purge 4-15 
d. Software Distribution 4-16 
e. Volume Interchange 4-16 
f. Complete Save 4-17 
g. Disk Compaction 4-17 


(see also Section 4.12) 


Discussion of Partial Dump/Restore includes: 


4.1.1 Ном to Use This Option 4-17 
4.1.2 Operations 4-19 
4.1.3 Special Cases 4-38 
4.1.4 Usage: Strategy and Tactics 4-41 
4.1.5 How to Do Partial Tape Dump Jobs: 
Predefined ("Canned") Operations 4-44 
4.1.6 Error Messages 4-47 
4.1.7 Statistics 4-50 


Section 4.2, Add or Modify Tape Dump Instruction Files (option 
K in the utilities menu), includes: 


4.2.1 The Default Builder IADEFBUILD 4-52 
4.2.2 Contents of IA.DEFAULT 4-55 
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Tape Cartridges and the Tape Drive 


Your system includes a high-speed cartridge tape for backup 
use. The drive uses 1/4-inch, 450 foot tape cartridges, which 
hold over 45 megabytes (or, in some cases, 60 MB) of format- 
ted data. 


The tape drive operates in "streaming" mode. Using the Partial 
Tape Dump option, it requires from 30 minutes to an hour and a 
half to create a backup tape for data on a 60 MB hard disk with 
a 45 MB drive (or with a 60 MB drive using one tape). The 
actual time depends on the number and size of the volumes. 


The streaming drive checks data as it is being recorded on tape. 
Checking is accomplished by a system of double tape heads: as 
one head writes the data, a second head reads and verifies the 
newly written data. If an error is detected, a signal is given to 
rewrite the block in question. (Newly written data is verified by 
the hardware. However, use the program's Verify option to 
ensure that tape and disk data are actually identical, and that no 
data has been lost or garbled during transmission.) 


Cleaning the Tape Drive 

The PLAN 3000 and 5000 File Servers may have either a 
Wangtek or Archive Tape Drive; the PLAN 4000 has an Archive 
Tape Drive. The cleaning procedure differs slightly, depending 
on the manufacturer. 


Refer to Figures 4-1 through 4-5. 


Warning: Head cleaning should be performed with the power 
off. 


To clean an Archive Tape Drive, perform the following tasks: 


(1) To expose the tape head, push the lever to the right. 


PARTIAL TAPE DUMP RESTORE 


(2) Moisten a clean, 6-inch cotton swab with head cleaning 
solution or an isopropy! alcohol solution. Locate the tape 
head and capstan (a flashlight may help) and rub them with 
the swab (do not use excessive force). 


(3) To remove the alcohol residue, take a clean swab and dry 
the tape head and capstan. 


(4) Push the lever to the left to pop the head back in place. 
To clean a Wangtek Tape Drive, perform the following tasks: 


(1) To expose the tape head, push on the base plate with your 
fingers. 


(2) Moisten a clean, 6-inch cotton swab with head cleaning 
solution or an isopropyl alcohol solution. Locate the tape 
head and capstan (a flashlight may help) and rub them with 
the swab (do not use excessive force). 


(3) To remove the alcohol residue, take a clean swab and dry 
the tape head and capstan. 


(4) Push the base plate to pop the head back in place. 
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Figure 4-1 
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Figure 4-2 
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Figure 4-3 
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Figure 4-5 
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Daily Backups 
(Canned Operation #1) 


Partial Tape/Dump Restore is commonly used for incrementally 
backing up the system's hard disks. This could be accomplished 
using Full Tape Dump/Restore but you would have to copy all of 
the disk bit for bit. You may find it advantageous to do this 
operation with the Partial Tape Dump/Restore option because: 


— daily backups are usually smaller (require less data) than 
complete backups. 


This smaller size means: 


— the time to run a daily backup is shorter; 

— the backup will in general require fewer tapes. In most 
cases, a daily backup will not require more than one 45 MB 
tape. 


This is true because: 


— the tape may not need to be changed; 

— the Partial Dump option allows you to specify multiple disk 
backups as one operation (which Full Dump does not); 

— you can restore part of the backup tape; with Full Dump, 
you must restore the whole tape onto a disk. 


Selective restoring using Full Tape Dump requires two hard 
disks of the same size: 


— back up Disk A (the disk you will not be restoring selec- 
tively); 

— restore the backup tape containing the files to be selec- 
tively restored to Disk A; 

— use the Copy Partial Disk option to copy the files across 
from Disk A to Disk B; 

— restore Disk A to its original state. 
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Obviously it is easier to do this sequence as a single operation 
with the Partial Tape Dump option. Unless you have two hard 
disks of the same size, you cannot do selective restoring at all 
without using this option. 


For more information, see Section 4.1.5. 


Archive and Purge 
(Canned Operation #2) 


Use this option to archive files and then purge them from your 
hard disks. The normal procedure is to do an occasional 
archive. purge run that saves and then deletes files that have not 
been used since the last archive, purge run. This operation could 
be done every month. Three common variations on this theme 
are: 


(1) To do a daily backup at the same time. 

(2) To do a backup of all files that have been changed since the 
last run. (This would give a monthly base to go back to. 
Monthly backups, saving data over time periods of years, 
prove valuable when bad data of long standing has been 
discovered.) 

(3) To archive and purge a related group of files. (This may be 
appropriate when a large project has been finished and is 
not likely to be changed or used soon.) 


The reason for purging files is to free up disk space and so 
make better use of this resource. 


For more information, see Section 4.1.5. 
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Software Distribution 
(Canned Operation #3) 


We mentioned archiving a related group of files in the previous 
section. You can also use the Partial Dump option to do 
software distribution using this mechanism; just omit the "purge" 
step. There are a number of advantages to distributing software 
on cartridge tape compared to distributing it on diskettes: 


— it is easier for the user to load it up because the complete 
transfer can be done in a single Partial Restore operation; 

— it is administratively easier for the distributor, because all 
relevant software can be loaded onto a single shippable unit 
(most large systems will not fit onto a single floppy disk); 

— for extra security, the distributor can put two copies of each 
file onto the tape. 


The disadvantage of using the Partial Dump option for software 
distribution is that it only operates on virtual volumes (data files); 
it cannot transfer only selected files (e.g., UCSD files) within a 
given virtual volume. 


For more information, see Section 4.1.5. 


Volume Interchange 

(Canned Operation #4) 

This operation is used to update software. Instead of deleting 
old volumes and replacing them with new ones, this operation 


simply overwrites the old volumes on disk with new ones from 
tape. 
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Complete Save 
(Canned Operation #5) 


This operation copies а! disk volumes onto tape, compacting 
them as it does so. (The Full Tape Dump operation, on the other 
hand, mirrors the volumes onto tape, leaving free sectors in 
place.) For more on disk compacting, see Section 4.12. 


Disk Compaction 


As virtual volumes are deleted and others added, the disk may 
become fragmented. In other words, the free space on the disk 
eventually becomes split into many small areas that cannot be 
allocated as a single volume. Compaction is the cure for frag- 
mentation, and this utility option allows you to compact a disk. 


For details on how to compact (or "crunch") a hard disk. see 
Section 4.12. 

4.1.1 How to Use the Partial Tape Dump/Restore Option 

To use this option, power on the file server. Press Еѕс > if you 
want to use the utility from tape or any disk other than the 
default disk (#1). Whether you use the default disk or not. type 
<Esc> when the "10 seconds" prompt appears; the utility menu 
will appear. Select option B from the utility menu that appears 
(by typing B =. Return >). 

If the file server is running, type 


[< Esc < password - -. Return» QUIT < Return-- 


to leave the program and reach the menu (brackets indicate an 
optional password). 


After you type B <:Return=, a welcome banner appears. 
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Next, a menu of Partial Tape Dump;Restore operations will 
appear: 


S(AVE, R(ESTORE. L(IST. Q(UIT: 


To specify an operation, type the first letter of the operation and 
then = Return >. If you want to quit the program, type “Q” and 
-Return-^. All the other operations run portions of the partial 
tape dump (see Section 4.1.2 for a description of how the other 
commands work). These other commands sometimes return to 
the option's command level after an error or if you quit a specific 
operation. 


How to Input Responses 


To input a response, type your information and then follow it 
with a <Return=-. 


You can sometimes input a "null line." To input a null line, just 
type <Return>. 


At most prompts, the program also allows you to input = Esc:* 
(i.e., type <Esc> <Вешт-> to signify that you want to escape 
from this line of questioning). When the program recognizes 
<Esc>, it jumps back to the previous round of questions. 


Date/Time Values 


System dates consist of the date and time as a 12 digit number 
of the form: 


YYMMDDhhmmss 


where "ҮҮ" is the last two digits of the year and “ss” is seconds. 
To input a date, you must either enter the date as six digits or 
else all 12 digits. The program performs some validity checking 
on date values you enter (although this is not exhaustive). If 
your input fails this validity checking, the program responds 
"?МОТ A VALID DATE" and prompts you for the date again. 
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Screen Display 


When the program has finished asking you questions and 
moved on to process the requested operation, it lays out the 
Screen in a well-defined way. Most of the display should be 
self-explanatory. 


4.1.2 Operations 
This section describes the following operations: 


S(AVE 
R(ESTORE 
L(IST 


4.1.2.1 S(AVE 


The S(AVE operation saves data on the hard disks by transfer- 
ring it to tape. 


The S(AVE operation uses 11 different types of parameters to 
govern how it selects and transfers virtual volumes. For your 
convenience and safety, you can specify most of these parame- 
ters as one of eight "canned operations" and have them brought 
in from disk each time you use the Partial Tape Dump option. 
Five canned operations are provided with the original software 
(see Section 4.2). 


The following section describes the two modes of specifying the 
parameters in more detail and what each of the parameters 
mean. When you use a canned operation you must know how 
to identify it, and also how the parameters are set. Some 
parameters are always set from the canned operation; others 
will sometimes be set directly or the program will prompt you for 
them; and the labels are always set from your input. This sec- 
tion describes this process and the operation of the program 
once you have set the S(AVE operation going. 
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Canned And Special Operations 


The Partial Tape Dump utility includes a number of predefined 
operations (called "canned" operations). Option К in the utility 
menu, Add or Modify Tape Dump Instructions (Section 4.2), 
allows you to add to or change these operations. 


When you do not use one of the canned S(AVE operations, you 
have to use the special S(AVE operation. In this operation, the 
program will prompt for values that S(AVE needs to run. 


You need to supply much less detail if you use a canned opera- 
tion. Here is how canned operations work in general. 


(1) A file called IA.DEFAULT has space for eight canned opera- 
tions and five of these are initialized on the distributed ver- 
sion to a set of standard canned operations. The five stan- 
dard canned operations are listed in Section 4.2.2. 


(2) You can alter the distributed IA.DEFAULT by using option К 
of the utility menu (Add or Modify Tape Dump Instructions). 
Option K is described in Section 4.2. 


(3) When you run the Partial Tape Dump option and use the 
S(AVE operation, it first asks you 


WANT TO USE A CANNED OPERATION (Y:N): Y 
The default here is "Y" to use a canned operation. If you 
take this default the program will then try to find the file 
IA.DEFAULT. |f this is not present (for example. if you 
have not copied it onto the disk you booted from) then the 
program responds 

CAN'T FIND "IA.DEFAULT" FILE 


Then the program asks again if you wish to use a canned 
operation. 


If an IA.DEFAULT file is found, the program will ask you to 
identify the canned operation. 
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(4) Once you have identified a canned operation. the program 
will print a description of the operation and ask you to verify 
that it is the correct one. If there are any dates to be 
entered, the program will ask for them. 


S(AVE's Parameters 


By setting S(AVE parameters, you can control how S(AVE will 
operate. The following five subsections describe in detail the 
meaning of these parameters; the remaining subsection points 
out some interactions between the parameters. 


Selection Directives 


The three selection directives tell the S(AVE operation how to 
select files for saving. 


1. Date Dependency 


The main reason files are selected for saving is that they have 
been modified. The first S(AVE parameter tells the program 
which date, if any, to use in deciding whether or not a virtual 
volume should be saved. The program asks you for this param- 
eter with the prompt: 


Select files by: 


B(ackup date — files that have been modified since they 
were last backed up. 


Y(our date — files that have been modified after a date you 
input. 


А(! — backup all files, regardless of when they were last 
modified. 


Enter "B","Y" or "A"; or you can enter null to choose the default 
of "B". The responses and their meanings are: 
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A: All files. All requested virtual volumes are selected, 
regardless of when they were last modified. 


B: Backup date. The file server keeps a "last backup date" 
for each virtual volume. If you choose this option, the 
program compares the "last backup date" against the 
"last modified date" for the virtual volume and selects the 
file for saving if the modify date is after the backup date. 
In other words if the virtual volume has been changed 
since it was last backed up, it will be saved. This option is 
the default because it will be what you normally want to 
use if you are doing incremental saves. 


Y: Your date. Input a date that the program will compare 
against the "last modified date" for each virtual volume. 
Virtual volumes that have been modified after your date 
will be selected for saving. 


2. Modify Date 


If you Choose the "Y(our date" option on the previous question, 
the program prompts you for your date with the question 


YOUR DATE: 
Enter a date of the form YYMMDDhhmmss (see 4.1.1 for details 
of entering dates). If you enter a date that is after today's date, 
the program types 

?IMPOSSIBLE - AFTER TODAY'S DATE 


and asks you for your date again. 


If you choose the "B(ackup date" or "А(!" options on the previ- 
ous question, the program does not ask you for "Y(our date". 
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3. "DON'T SAVE" Name List 


The "Don't Save" Name List is a list of filenames that you do not 
want to be selected for saving. The idea of this field is to save a 
lot of time on a daily backup run by excluding transient virtual 
volumes from consideration. Two common examples of tran- 
sient files are "QUEUE" and "NEWMAIL" files. To specify that 
you do not want virtual volumes that have these filenames in 
their pathname to be saved, you should enter 


NEWMAIL, QUEUE 
to the prompt 
DON'T SAVE NAME LIST: 


The "Don't Save" Name List is an important factor in speeding 
up the daily backup if you use the Messenger program because 
it can create very large numbers of small NEWMAIL files. You 
should also consider examining the files in your installation to 
see if there are applications producing transient files that you 
coüld exclude via the "Don't Save" mechanism. 


The following rules apply to the "Don't Save" Name List: 
— it must not be longer than 80 characters; 
— use separate filenames with commas; 


— you can enter characters in lower case: they will be con- 
verted to upper case; 


– a pathname will be excluded from the save process if one 
of its filenames below the main pathname is the same as 
one of the filenames in the "Don't Save" Name List. 


Note the phrase "below the main pathname" in this last rule. 
This means that if the "Don't Save" Name List contains 
"QUEUE" and you specify "MAIN/SYSTEM/QUEUE'" as опе of 
the main pathnames, it will be saved in the normal way. This is 
different from the action of the "Dont Purge" Name List 
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described below, which would stop this from being purged. The 
reasoning behind this policy ts that if you explicitly specify a 
pathname, you want to save it, even if it does conflict with the 
"Don't Save" Name List 


Transfer Directives 


1. RENAME PATHNAMES 
The program asks you this question with the prompt 
RENAME PATHNAMES ON TAPE (Y/N): 


If you enter "N" or null, the virtual volumes will be given exactly 
the same pathname on tape as they have on disk. № you enter 
"У", you will be able to rename virtual volumes as they are put 
on the tape. See the subsection "Pathnames" below for more 
details on renaming. 


2. VERIFY 


If you want to verify that the data on the tapes matches the 
information on the disk, you can request that a verification 
phase be included in the S(AVE operation by entering "Y" in 
response to the prompt 


VERIFY TAPES AFTER SAVING (Y/N): Y 
If you respond with "N" or null, the verification phase is omitted. 
Note: Although a tape dump without verification will be com- 
pleted approximately three times as fast as with verify, its use is 
not normally recommended except in special, occasional cir- 


cumstances where the additional verification time would other- 
wise make the tape dump operation impossible to perform. 
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Purge Directives 


1. PURGE 
The first purge question you will be asked is 
WANT TO DO ANY PURGING (Y/N): 


If you respond with "N" or null to this question, the S(AVE 
operation will omit all the other questions in this section and will 
not do any purging. 


Warning: The Partial Tape Dump utility saves. verifies, and 
purges volumes in separate passes. lf an error occurs during 
the Save or Verify of a volume, the Save of the volume is not 
retried, but simply aborted. The utility then continues with the 
next volume. The purge pass of the program assumes that the 
volume was saved and will delete it. If an error occurs during 
Save or Verify, you will be asked if you want to continue. If you 
have selected purging, you should abort the program. Other- 
wise, you may purge a volume that has not been saved. 


2. PURGE DATE 

The program asks you for the purge date with the prompt 
PURGE FILES NOT ACCESSED SINCE: 

You must enter a date here; see Section 4.1.1 for details of 

entering dates. All virtual volumes that have not been read or 

written after the data you input will be purged (on the assump- 

tion that they are no longer being used). 

The utility allows you to enter a date in the future in answer to 


this question. As no virtual volumes will have been accessed 
since that date, all files will be purged. 
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3. "DON'T PURGE” Name List 


The "Don't Purge" Name List allows you to list the filenames 
that should never be purged. This does the same for the purge 
phase as the "Don't Save" Name List does for the save phase. 
See the "Don't Save" Name List Section above for the format 
and content of a Name List. Note that filenames in the "Don't 
Save" Name List are also implicitly included in the "Don't Purge" 
Name List; see the "Interactions between Directive" section 
below for details. For your convenience and safety the program 
gives you a default of "SYSTEM" for the "Don't Purge" Name 
List. 


4. CONFIRM 
The final question about purging is 
WANT TO CONFIRM EVERY DELETE (Y/N): 
If you enter "Y" or null, the program will ask you to confirm the 


deletion of every file. If you do not wish to be asked these con- 
firmation questions, enter "N". 
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Pathnames 


You can specify a number of pathnames that you wish to have 
saved. If you answered "Y" to the "Rename Pathnames" ques- 
tion, you also have to specify a pathname with which to rename 
files on tape Here is an example of the original pathnames 
without renaming 


PATHNAME 1: MAIN 
PATHNAME 2. ALT 
PATHNAME 3: 


Note that a null pathname ends the questioning. An example 
with renaming is: 


РАТНМАМЕ 1: ;MAIN/PASCAL 
RENAME. TO: /COPY1/PASCAL 
PATHNAME 2: /MAIN/PASCAL 
RENAME TO: /COPY2/PASCAL 
PATHNAME 3: 


This example shows how you can use renaming to get two 
copies of the same files on a distribution tape. 


The maximum number of pathnames you can save is 16. 


This does not mean that you can only save 16 virtual volumes 
on the tape. The pathnames you specify can be directories (as 
in our examples above), in which case every virtual volume 
below the pathname will be eligible for saving. For example, if 
/MAIN/PASCAL is the pathname you specify, 
/MAIN/PASCAL.LIB is a virtual volume below /MAIN/PASCAL 
and so is eligible for saving. 


Label Entries 


When the S(AVE operation writes to the tape, it puts a label at 
the front of each tape cartridge. The label contains three com- 
ments of 40 columns each. The last three questions the S(AVE 
operation asks you for are these comments. You can enter up 
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to 40 characters for each comment to describe the tape. For 
example: 


LABEL 1: VRX 1.0 
LABEL 2: SOURCE CODE AND DOC 
LABEL 3: MADE BY: DIST ANL 


Note this example does not include a date; another part of the 
label holds today's date, which is automatically displayed when- 
ever the label comments are displayed. 


Interactions between Directives 


There are two interactions between S(AVE's directives that you 
should take note of. 


The first interaction is that the "Don't Save" Name List also 
implies that files affected by this list will not be purged either. 
This interaction is a result of how the "Don't Save" Name List is 
used. When the program is searching a directory for files to con- 
sider, any filename that is in the "Don't Save" Name List is 
ignored. The program does this so that it can ignore the whole 
tree of pathnames below that filename, and so speed up its 
operation. A side-effect of this implementation is that the pro- 
gram ignores the whole sub-tree for purge selection as well. 
One way to think of this is that the "Don't Save" Name List is 
automatically appended to the "Don't Purge" Name List. 


The other interaction is that if a virtual volume is selected to be 
purged but is not selected to be saved, the. program will save 
the virtual volume before purging it. 


There are two reasons for doing this. One is for added security. 
It is not possible with this utility to remove a file without a trace. 
The other reason is that the program should support an "Archive 
and Purge" mode of operation. This mode will normally operate 
on files that have not been accessed at all, and this is how the 
purge directives work. But the save selection directives are 
oriented towards files that have changed and so will not select 
files eligible ‘for purging. The program takes care of this 
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discrepancy by forcing the saving, or archiving, of files that are 
about to be purged. 


How Canned Operations Work 


If you want to use a canned operation and the program can find 
a defaults file, the S(AVE operation will display the reference 
numbers and names of the canned operations and ask you to 
identify the canned operation by number. For example, using 
the distribution IA.DEFAULTS file you would see: 


1 DAILY BACKUP 

2 ARCHIVE PURGE 

3 SOFTWARE DISTRIBUTION 
4 VOLUME INTERCHANGE 

5 COMPLETE SAVE 


WHICH CANNED OPERATION 
IDENTIFY BY NUMBER (0): 


If you wanted to do a daily backup, you would enter "1" and the 
program would respond with 


OPERATION - DAILY BACKUP 
OK (Y/N): 


Enter "Y" here if you have got the right operation; if not, enter 
"М" and the program will ask you for the canned operation's 
number again. 

Once you have identified the canned operation you want, the 
program fills out and verifies the information in the canned 
operation. It does this in the following way: 


(1) If the date dependency is to select files for saving by Y(our 
Date, the program asks you for "Your Date." 


(2) If the canned operation includes purge directives, the pro- 
gram asks you for the purge date with the prompt: 


PURGE FILES NOT ACCESSED SINCE: 
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(3) If the canned operation specifies any pathnames, the pro- 
gram checks that they exist on hard disk. 


(4) If the canned operation does not include any pathnames or 
if any of the pathnames are invalid, the program prompts 
you for the pathnames. 


All other information that the S(AVE operation needs is taken 
without modification from the canned operation's values. 


Other Phases Of S(AVE 


Once the S(AVE program has gathered the information neces- 
sary to operate, it will confirm that you wish to start the program 
by asking you 


OK TO GO (УМ): 


If you enter "Y", the S(AVE operation will start on other phases 
as follows: 


(1) The program lays out the screen and asks you to put in the 
first tape. 


(2) The program writes some list records and then some virtual 
volumes. The list records are recorded to make the L(IST 
operation (described below) fast; the virtual volumes hold 
the actual data saved. Because the list records must be at 
the front of the tape, the utility program always starts a new 
tape. You cannot append onto an existing tape. 


(3) The tape is rewound. 


(4) If you have specified that verification be done, the program 
does a verify phase that matches steps 1 to 3: 


— if the save process took more than one tape, it asks you 
to re-insert the first tape; 

— it verifies the list records and then the virtual volumes; 

— the tape is rewound. 
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(5) Having successfully completed the save and verify opera- 
tions, the program now sets the last backup date for each virtual 
volume that has been saved. 


(6) If you want to purge some files, the program enters a "Purg- 
ing Unused Files" phase. 


If you want more detailed information on how the program 
works, see Section 4.1.5. 


Note that if all the saved data fits on one tape and there is no 
need to confirm purges, the program will do all the phases of 
the program without any further interaction necessary after the 
tape has been loaded. This makes the normal daily backup 
operation, where both these conditions should apply, particularly 
convenient. 


4.1.2.2 R(ESTORE . 

The R(ESTORE operation transfers data from the tape to the 
disk. This operation is called R(ESTORE because its main use 
is to retrieve from tape programs that have been purged (or 


accidentally lost) from the hard disk. The following two subsec- 
tions describe R(ESTORE's parameters and its operation. 


R(ESTORE's Parameters 


1. Confirmation 


R(ESTORE first asks you what type of confirmation you want to 
use with the prompt: 


WHICH FILE DO YOU WANT 
TO CONFIRM RESTORE FOR: 


A(LL O(VERWRITE N(ONE (0): 


You must enter "A", "О" or "М"; or you can enter null to choose 
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the default of "O". The responses and their meanings are: 


A: You will be asked to confirm each file before it is 
transferred to disk. 


O: You will be asked to confirm the transfer of files that will 
overwrite existing files. This gives you the chance to 
select specific files from a group of files: 


N: You will not be asked to confirm any transfers. If you 
specify this option, you will be asked the question 
described in the following subsection. 


2. No Overwriting 


If you answer "N" (for no confirmation) to the previous prompt, 
the program then asks you: 


WANT TO OVERWRITE ANY EXISTING FILES (Y/N): 


If you enter "N" or null, the program will not transfer files that 
already exist on the hard disk; if you answer "Y" the program 
will transfer these files. 


The advantage of answering "№" to this question is that the pro- 
gram will process each saved tape without operator intervention. 
The disadvantage of this usage is that the program may do 
things you do not expect. In the "no overwrite" case, the pro- 
gram may not transfer files that you expected to be transferred 
and in the "overwrite" case, it may encounter files on tape you 
had forgotten about and overwrite existing files. Obviously, the 
automatic overwriting mode of operation is potentially dangerous 
and you should use it with care. 
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3. Rename Pathnames 
The program asks you this question with the prompt 
RENAME PATHNAMES ON DISK (Y/N): 


If you enter "N" or null, the virtual volumes will be given exactly 
the same pathname on disk as they are on tape; if you enter 
"Y". you will be able to rename virtual volumes as they are put 
on disk (see the next section for details). 


4. Pathnames 


You can specify a number of pathnames that you wish to have 
restored. If you answered "Y" to the "Rename Pathnames" 
question, you will also have to specify a pathname with which to 
rename files on disk. The prompting for these pathnames is 
exactly the same as for the S(AVE operation. The maximum 
number of pathnames you can specify here is 16. This does not 
mean you can only restore four specific virtual volumes because 
you can restore complete directories. The next section 
describes how directories are restored. 


Other Phases of R(ESTORE 


Once the program has asked the above questions, it prompts 
you with 


OK TO RESTORE (Y/N): 


You must enter "Y" or "N". "N" quits R(ESTORE back to the 
main prompt; "Y" lets the program continue as follows: 


(1) The program lays out the screen and asks you to put in the 
first tape. 
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(2) 
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Now the program must find some files on the tape that are 
eligible to be restored. To show how it does this, assume 
we have the following saved tape: 


MAIN PATHNAME = /MAIN/USERS/ME 
;MAIN/USERS, ME/1 
i/MAIN/USERS: ME/2 


MAIN PATHNAME = /ALT/WORK: YOU 
/ALT. WORK YOU:P 


MAIN PATHNAME = ,ALT. WORK BETA 
ALT WORK.BETA 


MAIN. PATHNAME = ;ALT.LIB 
АІТ LIB, PASCAL'’SOURCE 
ALT LIB: PASCAL OBJECT 

‚ ALT LIB, PASCAL CODE 

ALT НВ.СРМ, 1 


And also assume you have specified the following path- 
names to search for: 


.. MAIN.USERS;/ME 
АЕТАМОВК 
'ALT/LIB/PASCAL 
. ALT/LIB/DOS 


Boo 


Here is how R(ESTORE would operate: 


(a) It would find /MAIN;USERS.ME on the tape, the main 
pathname which exactly matched a pathname to 
restore. It would try to restore all the virtual volumes in 


this group and mark the first pathname to restore as 
being completed. 


(b) The next pathname on tape is /ALT/WORK;/YOU, which 
is below the second pathname to restore, , ALT/WORK. 
The program tries to restore all the data files in the 
group but it does not mark ;ALT/WORK as being 
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completed. This is because there may be more files 
on the tape other than those below /ALT/WORK/YOU 
that are below /ALT/WORK (ог example, 
;ALT/WORK BETA). 


(с) The program does exactly the same for 
ALT WORK;BETA when it finds it on the tape as for 
the group below /ALT/WORK/YOU. 


(d) Now the program finds ,ALT/LIB on the tape. This is 
not matched in the pathname at or above it so the pro- 
gram should not restore all the virtual volumes in this 
group on the tape. However, there are two subdirec- 
tores ої ALT;LIB we are looking for, 
ALT LIB. PASCAL and .ALT/LIB/DOS so the program 
must partially restore this group of virtual volumes: 


- it tries to restore all the ALT,LIB/PASCAL files 

- when it encounters /ALT,/LIB/CPM/1 it marks the third 
pathname to restore ALT;LIB/PASCAL as complete 

— it ignores ;, ALT/LIB/CPM/I 

— on reaching the end of the group, knows it will never 
satisfy the fourth pathname to restore, 
/ALT/LIB/DOS. 


(3) In its attempt to restore a given file, the program generates 
the name to use for the file on disk if you have specified 
renaming of files. If this new name is more than 80 charac- 
ters, the program will issue the error message 


?ВЕМАМЕО PATHNAME WOULD ВЕ TOO LONG 
and move onto the next file on tape. Next, the program will 
ask you to confirm that you want to transfer the file if that is 


appropriate. It does this by displaying, for example: 


GOING TO TRANSFER 
‘ALT/LIB/PASCAL/SOURCE 


on the bottom portion of the screen, and prompts you with 
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OK TO DO TRANSFER? 
just above it. 


If you answer "Y". the program then tries to re-create the 
file on disk. 


If there is not enough space to create the new file, the pro- 
gram prints an error message, such as 


NOT ENOUGH SPACE TO CREATE 
'ALT/LIB/PASCAL SOURCE 


Note that if you get this message, the program will have 
already deleted any existing file of the same name. This 
means: 


— if you are replacing an existing file of the same size, 
you should never get the "NOT ENOUGH SPACE" 
message; 


— if you do get this message and there was. an existing 
(smaller) file, it will have been lost. 


If the file is successfully created and restored, you should 
be aware of the following points: 


— Any necessary intermediate directories are created. If 
you are restoring files without renaming them, the pro- 
gram creates any necessary intermediate directories 
up to and including the tape group's pathname. In all 
other cases, the program creates only necessary inter- 
mediate directories with the file server's default access 
rights. The "other cases" referred to here are when vir- 
tual volumes are being renamed as they are being 
restored, and when directories must be created above 
the tape group's pathname. Note 


— Most of the attributes of the virtual volumes are copied 
directly from the tape onto the disk. 
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The implications of this last point are: 


— Passwords and access rights will be the same. There- 
fore, if you are doing a distribution tape, you should 
make sure that the passwords you use internally are 
removed for any distributed files. 


- Because the "last modified date" is the same, any files 
restored from long term archives will not be saved by a 
daily backup run. 


— The original creation date is kept. We prefer to do this 
rather than update the creation date with the date of 
the restore. . 


The only date that is altered is the "last accessed date", 
which is set to today's date. The program does this so that 
the file will not be purged at the next "Archive and Purge" 
run. 


(4) The program does try to stop searching the tape as soon as 
possible. It can stop when it knows for each pathname that 
it has completed the restore for that pathname or that it will 
never find it. 


(5) When the R(ESTORE is finished, the program lists any files 
it has not found, for example: 


NOT FOUND: 
/ALT/LIB/DOS 


4.1.2.3 L(IST 

The L(IST command allows you to list the names of the virtual 
volumes on a set of tapes generated by the S(AVE operation. 
First, the program asks you if you want to spool the listing to the 


printer with the prompt 


CREATE PS LISTING OF FILE (Y/N): 
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(PS refers to the PLAN Server print system.) 
If you answer "Y" or null, the program prompts you with a, 


FOR SPOOLED FILE, ONE SECTOR HOLDS INFORMATION 
ON APPROX, 3 VIRTUAL VOLUMES 


LISTING FILE SIZE IN SECTORS (400): 


If you enter null, the listing file will be able to hold information on 
about 160 virtual volumes. If the tape holds more than 160 
volumes, you should enter a correspondingly larger number. 
Finally for spooled listings, the program creates the listing file 
and writes a message such as 


SPOOL FILE WILL BE WRITTEN TO: 
:MAIN/SYSTEM/QUEUE/NEW/25200000A.LIST 


This type of spool file will be automatically printed by the net- 
Work print server. 6 


The program asks you to input the first tape іп the set and then 
does a display on the screen. The display shows the main path- 
names, and then the type and name of each file on the tape 
under that pathname. The display uses the list records that are 
written by S(AVE, especially for the L(IST operation. This 
means that the program does not have to search through the 
data to do the listing and so will only use the first tape to do the 
list. 


The list command displays the pathnames quite quickly if you 
are not having a spooled listing created. If you want to look at 
the display at a given point, you can type <Ctrl> S to freeze 
the display (and <Ctrl> О to unfreeze). 


4.1.3 Special Cases 
This section describes some special cases that the utility pro- 


gram must be aware of. Normally you will not need to worry 
about the cases described here. If you are reading this manual 
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for planning purposes, skip this section and refer back to it if 
necessary 


Startup: Two Hard Disks Have Same Name 


When you first start the Partial Tape Dump option it will read the 
names of all hard disk units. If any two drives have the same 
name, the program will respond, for example 


1 AND 4 ARE BOTH CALLED /MAIN 


and quit the program. It does this because it restores from tape 
using symbolic names and it does not know to which disk to 
restore MAIN files. To change а disk's name, you can use the 
Examine Disk Contents utility (option H in the utility menu). 


Save: Maximum Number of Names per Pathname 


The Partial Tape Dump option can handle up to a fixed number 
of intermediate directories in a pathname (currently seven). This 
implies that the maximum number of filenames in all is nine. 


If the program tries to process an eighth intermediate directory, 
it will ignore the directory and print, for example: 


?FOLLOWING DIRECTORY EXCEEDS MAXIMUM LEVEL 
;MAIN/USERS/ME/DATA/A/V1/TSKC/LIB;/ SO/PB 


This is more restrictive in theory than the file server, which will 
let you create any number of intermediate directories. In prac- 
tice, most users of the system only use up to six-name path- 
names anyway. If you do hit this restriction, you can get around 
it by saving a lower pathname. For example, the above virtual 
volumes would be saved successfully if you specified 
“MAIN; USERS" as the main pathname to be saved. You can 
also use the file server MOVE command (from the file server 
console or by using the NET program at a user workstation) to 
move the contents of the directory to a directory closer to the 
root directory. 
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Restore: Of Boot Volume 


Because the boot volume has a special significance on a disk, 
the Partial Dump utility program will prevent you from overwrit- 
ing an existing boot program. !n addition, it does not set up the 
boot program even if you restore 


'MAIN. SYSTEM FILESERVER 


i.e., it will not enable the disk to boot automatically. If you do 
want to restore a boot volume from tape, you must do the fol- 
lowing: 


— Restore the boot volume to a different name, such as 
MAIN. SYSTEM/NEW FILESERVER 


— To let the system boot from this volume, use the SETBOOT 
utility of option H, Examine/Modify Disk Contents. 


-if you now want to rename the boot volume to 
;MAIN; SYSTEM/FILESERVER, do so using option Н or the 
user station NET program (after deleting the old 
/MAIN/SYSTEM/FILESERVER). 


Restoring Below Nondirectory Pathnames 


It may happen that you try to restore below a nondirectory path- 
name. This can happen if you are renaming pathnames when 
restoring them, or if the directory structure has been altered. In 
this case, the program will not be able to restore the volume. It 
will print (for example) 


INTERMEDIATE PATH NOT A DIRECTORY 
»MAIN/USERS/ME/1 
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4.1.4 Usage: Strategy and Tactics 


The previous sections describe how to operate the Partial Tape 
Dump/Restore utility. The following sections describe in detail 
some ways of using the utility. The first section discusses how 
to combine various uses of the Partial and Full Tape Dump utili- 
ties in a backup strategy; the second section describes how to 
operate the Partial Dump utility to put it to certain uses. 


Backup Strategy 


The system manager should ensure that an installations hard 
disks are backed up. Any backup strategy should: 


(1) Allow single files to be restored in case of data loss on a 
small area of the disk or after accidental deletion. 


(2) Give protection against catastrophic disk errors like head 
' crashes. 


(3) Use the hard disk effectively by "ed and purging 
unused files. 


(4) Give protection against fire. 


(5) Give value for money. This means you should match the 
cost of your backups (in tape cost, operator time and sys- 
tem down-time) against the value of the information on the 
hard disks. 


Remember that for any computer system, data loss is increas- 
ingly probable as the system is used. Error-free periods of 
operation often cause system managers to overestimate the 
long-term reliablity of their systems. Further, the most reliable 
system is susceptible to human error. 


Obviously, the system manager must decide how to achieve 
item (5) above because the number and frequency of backups 
will vary between installations. However, we can propose the 
following scheme of backups that will meet the first four 
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requirements: 


(1) Do daily backups using the utility to save valuable changed 
files (in order to be able to restore single files). 


(2) Do a weekly Full Tape Dump (to protect against catas- 
trophic disk failures). 


(3) When a disk becomes full (or every three months): 


- do a Full Tape Dump; 

— delete any unwanted files; 

— purge any files that have not been accessed in the last 
two or three months and compact the full disk (see Sec- 
tion 4.12). This will ensure that the disk is used effec- 
tively. 


(4) Keep all backup tapes protected from fire in the computer 
room, either by putting them in a fire safe room or taking 
them off-site. 


Noté that each step number above satisfies the strategic objec- 
tive with the same number. Within this framework, we can 
define two extremes of frequencies and costs for the backups: 
a low-cost and a high-cost strategy. 

The low-cost backup strategy is: 


(1) Ignore daily backups entirely. 


(2) Do a weekly Full Dump using alternate sets of tapes. (Be 
sure to rotate the tapes). 


(3) When you need to compact a disk, use the weekly tapes to 


do it with: use one set for the Full Tape Dump and the other 
set for the Partial Tape Dump. 
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The high-cost strategy is. 


(1) Do a daily backup of valuable changed files every day, 
which should only require one tape for most installations. 
Have one tape for each day of the week, except for the 
weekly Full Tape Dump. This will require four or five tapes. 


(2) Do a weekly Full Tape Dump and have three complete sets 
of full dump tapes. 


(3) Keep four rotating 3-monthly full dump tapes. This will give 
you the capability if necessary of retrieving tapes from up to 
one year ago. 


(4) When you have to compact a disk, keep each partial dump 
tape that has archived and purged files on it for three 
months. 


You may find both these ends of the cost spectrum to be unac- 
ceptable in which case you can define an intermediate strategy. 


Note that we have only discussed system-wide backups here. 
You may find some user groups will require you to back-up very 
valuable or sensitive material more frequently than the average. 


Remember when you are calculating the number of tapes you 
will need that every Partial Dump S(AVE takes an integral 
number of tapes. You cannot squeeze a number of small 
backup runs onto one tape. 
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4.1.5 How to Do Partial Tape Dump Jobs: Predefined 
("Canned") Operations 


Daily Backup and ІАЕХЕС 
(Canned operation #1) 


This operation on the distributed IA.DEFAULT file implements 
daily backup. This may be customized. 


— The "Don't Save" Name List is "NEWMAIL,QUEUE". The 
intent here is to save time on the daily backup by avoiding 
these small, transitory files that (in the case of NEWMAIL 
files) can account for a large percentage of the number of 
files on a disk. If your installation generates any other files 
of this nature, you may want to add them to the "Dont 
Save" Name List. 


— The verify indicator is "N", again to save time. You may 
want to change this to "Y", which will take longer but be 
more secure. The hardware automatically verifies that data 
is written onto the tape correctly. However, if the data that 
arrives is somehow incorrect (for instance, garbled in 
transmission), the Verify option will detect the difference 
between disk and tape. 


— You should probably change the pathnames to use the 
correct symbolic names of your disks. 
Archive and Purge 
(Canned operation #2) 
This operation on the distributed IA.DEFAULT file implements 


the "Archive and Purge" operation. The idea here is to save and 
then delete (purge) unused virtual volumes. 
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Points to note: 


— We also have included here a daily backup because we 
have specified "Save depending on backup date". You may 
want to alter this to "your date" or "(all files)". 


— We have included NEWMAIL and QUEUE files іп the "Don't 
Save" Name List, and SYSTEM and MAIL files in the "Don't 
Purge" Name List. None of these file names will be eligible 
for purging. You may want to add file names to the "Dont 
Purge" Name List. 


— You should probably change the pathnames to use the 
correct symbolic names of your disks. 


Warning: The Partial Tape Dump utility saves, verifies, and 
purges volumes in separate passes. If an error occurs during 
the Save or Verify of a volume, the Save of the volume is not 
retried but simply aborted. The utility then continues with the 
next volume. The purge pass of the program assumes that the 
volume was saved and will delete it. If an error occurs during 
Save or Verify, you will be asked if you want to continue. If you 
have selected purging, you should abort the program. Other- 
wise, you may purge a volume that has not been saved. 


Software Distribution 
(Canned operation #3) 


This operation gives a framework for software distribution. The 
only point of interest here is the "Rename Pathnames" indicator, 
which is set to "Y". We have done this on the assumption that, 
for added data security, software distribution tapes should con- 
tain two copies of the same information. The way to do this is to 
use the Rename option, specify the same pathname to save 
twice, and rename it on tape to two different pathnames, for 
example: 


Pathname 1: MAIN.PASCAL 
Rename to : .MAIN/PASCAL 
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Pathname 2: MAIN: PASCAL 
Rename to : BACKUP/PASCAL 


Then if the user of the tape cannot restore the /MAIN/PASCAL 
files, he or she can try to restore the |(BACKUP;PASCAL files. 


Volume Interchange 
(Canned operation #4) 


This operation is used to update software. Instead of deleting 
old volumes and replacing them with new ones, this operation 
simply overwrites the old volume on disk with a new one from 
tape. 


Complete Save 
(Canned operation #5) 


This operation copies old disk volumes onto tape, compacting 
them as it does so. (The Full Tape Dump operation, on the 
other hand, mirrors the volumes onto tape, leaving free sectors 
in place.) For more on disk compacting, see Section 4.12. 


Recreating a Disk 


You may want to recreate a disk from its individual files for two 
reasons. One reason is if the disk has become unusable for 
some reason and you have a complete save of the disk made 
by the utility that is more recent than the last full dump tapes. 
The other reason is if the free space on the disk is highly frag- 
mented; by recreating the disk from the individual files, you will 
collect all the free space into bigger areas. 


You can recreate a usable disk using the Full Tape Dump, Full 
Disk to Disk, and Partial Disk to Disk utility options if you have 
two disks of the same size. If you do not have two disks of the 
same size, or one is unusable, you can recreate a disk from a 
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partial dump tape containing a complete save of the disk. 
Canned operation number 5 on the distributed IA.DEFAULT 
shows a COMPLETE SAVE. 


You may want to amend the pathnames on this canned opera- 
tion to their symbolic names. And, if you have more than one 
hard disk, you may want to split the complete save into separate 
canned operations, one for each disk (such as "SAVE MAIN" 
and "SAVE ALT"). 


To recreate the disk, you have to 
— use the format utility to initialize it; 


— run Partial Tape Dump to copy all files from the tape to the 
disk; 


- use the "Examine Disk Contents" utility and use its SET 
BOOT operation to allow the disk to be booted. 


The descriptions of the save and restore algorithms in Section 
4.2 give detailed information about what these programs do to 
implement the functions described in the previous sections. We 
have tried to address all common usages of the Partial Dump 
option. We have included the algorithms so that if you want to 
use the utility in a way we have not anticipated, you can use the 
algorithms to determine what it will do in special situations that 
are not otherwise discussed. 


4.1.6 Error Messages 


Under normal operation. the Partial Tape Backup utility will not 
return any errors. Errors indicate problems with either the 
hardware or the tape. Most error messages are of the form x: y, 
where "x" describes the general class of errors and "y" is the 
specific error that occurred. In most cases you will need to con- 
iact your network service representative. Record the complete 
contents of your screen, including the complete text of the error 
message, the files listed on the screen, and the information on 
the top few lines of the screen. This will help your service 
representative determine what the problem is. 
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DESCRIPTOR READ ERROR 

DISK OR DIRECTORY ERROR 

BAD DIRECTORY STRUCTURE 
or 

DISK ГО ERROR 


Indicates а problem with the hard disk. Run the 
"Examine/Modify Disk Contents” utility to verify the problem, 
record the results of this utility, and then contact your service 
representative. 


Note: When you run "Examine. Modify Disk Contents", respond 
"No" whenever it asks if you want to change the contents of the 
disk. You are running this only to collect additonal information 
for your service representative. 


MAX LEVELS EXCEEDED 


Indicates that you have directories nested deeper than the Par- 
tial Tape Backup utility will allow (the file server allows any 
number of intermediate subdirectories; the Partial Tape Dump 
utility currently allows seven). You should: (1) move the con- 
tents of the directory to a directory closer to the root directory 
(use the file server MOVE command from a user workstation or 
from the file server console) or (2) save a lower pathname. 
Specify a main pathname to be saved, and then the lower path- 
name, thus splitting the pathname into two pieces. 


VERIFY FAILED WHILE DOING "X" 

Indicates the data on the disk does not match what is on the 
tape. Clean the heads of the tape drive and use a new tape. If 
the errors recur, contact your service representative. 


"X" can be one of the following: 


— list record header - the tape will probably not restore. You 
should abort the backup and redo the save. 
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— list records - the List function may return incorrect data, but 
the Restore function will restore the data correctly. 
— end of list records 
— area terminator 
— area terminator file mark 
— file header 
- data file header. or 


— data file header file mark - the tape will probably not restore. 
Abort the backup and redo the save. 


—file - the tape is probably OK, but the contents of the 
volume that failed to verify are probably incorrect. You 
should save and verify the volume on another tape. 

— end of file - the tape will probably not restore; you should do 
the save over. 

FATAL ERROR: 
FATAL ERROR N: 
Indicates a fatal tape error. "N" is an internal error number that 
should be reported with the rest of the error message. This will 
be followed by the message: 

Tape Status $xx $xx $xx $xx: message, 
where message is one of the following: 

— Tape reset 

— Illegal command to tape drive 

— Parity error 


— End of tape 


All of these indicate problems with the hardware and should be 
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reported to your service representative. 


— No data detected 
— Tape hard data error 


If one of these occurs, clean the heads of the tape drive and 
repeat the operation on which the error occurred. If the opera- 
tion was a save, use a new tape as well. If the problem reoc- 
curs, contact your service representative. 


TBLKCMP FALSE : ab - 206 
Verify error in а  partialrestore header (Partial Tape 
Dump.Restore puts a header for each file on the tape). Should 
be followed immediately by a verify error. 
Clean the heads and retry using a new tape. If the error recurs, 
contact your service representative. 
4.1.7 Statistics 
Space Overheads 
The program writes delimiters on the tape to keep track of the 
different phases of its operation. These delimiters use ten blocks 
(2048 bytes) each on the tape. The usage of these delimiters is: 
— two per run 
— two per tape 


— two per group to save 
— one per data file saved 
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S(AVE Timing 
The timing of the elements in a S)AVE operation are: 
— time per delimiter: 5 seconds; 


— time to transfer 1KB from disk to tape: 1/30th second (i.e., 
the transfer rate is 30Kbytes/second); 


— time to find and process a data file in the file system: .75 
seconds (approximate average). 


These elements must be multiplied by the number of times 
they occur. For example, on a daily backup operation without 
verify, each data file is processed three times. On a daily 
backup operation with verify, each data file is processed five 
times and all tape operation times are doubled. The following 
table shows aggregate timings for various multipliers: 


Type Baseline Daily Daily 
(sm files) (lg files) 

Files 1 100 100 250 
Searched 1 100 100 
Files 1 20 20 250 
Saved 1 20 20 
MB 0.5 2.5 12.0 33 
Data 0.5 2.5 12.0 
Verify No No No Yes 

Yes Yes Yes 
Total 1 8 13 83 
Time 2 14 24 
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4.2 Add or Modify Tape Dump Instruction Files 


Option K of the utility menu allows you to specify your own Par- 
tial Tape Dump canned operations to the utility's S(AVE opera- 
tion (Section 4.1.2.1). The canned operations are contained in 
the file IA.DEFAULT. This option gives you a controlled way of 
manipulating this file. 


IA.DEFAULT has space for eight canned operations. Initially, 
five of the eight slots are set up with "standard" canned opera- 
tions, and three slots are unused. See Section 4.2.2 for the 
names and contents of the five standard slots. 


We recommend you try to define all your normal save opera- 
tions as canned operations because this will make your archiv- 
ing operations much more foolproof. 
4.2.1 The Default Builder IADEFBUILD 
To use this option, power up the file server. Press «Esc. # you 
want to use the utility from tape or any disk other than the 
default disk (41). Whether you use the default disk or not, type 
«ESC- when the "10 seconds” prompt appears; the utility 
menu will appear. Select option K from the utility menu. 
If the file server is running, type 

[<Esc> <раѕѕмога> <Return>]QUIT<Return> 
to reach the utility menu (brackets indicate optional password). 
The first thing IADEFBUILD does is look for the defaults file, 
IA.DEFAULT. If it cannot find this, the program prints the error 
message: 


CAN'T FIND DEFAULTS FILE "IA.DEFAULT". 


Then the program asks if the user would like to create one on 
the current volume. 
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If IA.DEFAULT is found, the program lists the current canned 
operations and then displays the main prompt which is: 


(МРОТ 
U(PDATE 
D(ISPLAY 
L(IST 
R(EMOVE 
H(ELP 
Q(UIT 


WHICH (D): 


To specify an operation, type the first letter of the operation only 
(or null to get the default of DISPLAY) and then <Return->. You 
must type <Return> here for the program to do anything. If you 
want to quit the program, type "О" and «Return. The other 
operations are described below. 


Identifying Canned Operations 


Some operations ask you to identify a canned operation. You 
can do this by entering: 


— the slot number for this canned operation, as shown by the 
L(IST operation 

— the whole name 

— the first few characters of the name, as long as it unambigu- 
ously identifies one of the canned operations. For example, 
to identify the "DAILY BACKUP" canned operation, you 
could probably identify it uniquely with just "DA". (Note that 
this facility is only present in the IADEFBUILD program.) 


IADEFBUILD's Operations 
The two most important operations are (МРОТ and U(PDATE. 
They both allow you to set the contents of a canned operation. 


(МРОТ finds an empty slot (if there is one) and blanks out the 
canned operation's contents; if there is no empty slot, you 
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cannot use I(NPUT. U(PDATE asks you to identify the existing 
slot you want to change; you cannot use U(PDATE on an empty 
Slot. These operations then prompt you for these fields: 


— the operation s name 

— the date dependency 

— the "Dont Save" Name List 

— the Rename Pathnames indicator 
— the Verify indicator 

— the Purge indicator 

— if purging is to be done 

— the "Don't Purge" Name List 

— the Confirm Purges indicator 

— the pathnames (and rename pathnames, if appropriate) 
— the three comments fields 


The defaults on these fields will be standard null defaults for the 
(МРОТ operation and the existing values for the canned opera- 
tion on U(PDATE. These operations are designed to look as 
similar to the special version of the utilitys S(AVE operation as 
possible. There are three differences between them: 


(1) You are not asked for dates in the canned operation (specif- 
ically, the modify and purge dates), as we assume they will 
change depending on when the canned operation is 
invoked. 


(2) You can specify no pathnames in the cannned operations. If 
you omit them, the utility program will prompt the operator 
for them when the canned operation is invoked. 


(3) If you do not specify one or more pathnames they are not 
checked against the current hard disks by the 
IADEFBUILD. Instead, they are checked by the utility when 
the canned operation is invoked. The R(EMOVE operation 
allows you to remove an existing canned operation. L(IST 
lists the eight slots, showing their numbers and names (or 
"(EMPTY)"). D(ISPLAY shows the current values in a given 
canned operation. 
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Once you have generated your own IA.DEFAULT file, it will be 


automatically saved. 


4.2.2 Contents of Incremental Archiver Default 


Canned Operation #1 


Operation Name 
Save Depending on 
Don't Save Name List 
Rename Pathnames 
Do Verify 
Do Purge 
Tape Labels: 

Label 1 

Label 2 

Label 3 


Pathnames to Transfer: 


/MAIN 


Canned Operation #2 


Operation Name 
Save Depending on 
Don't Save Name List 
Rename Pathnames 
Do Verify 
Do Purge 
Don't Purge Name List 
Confirm Purges 
Tape Labels 
Label 1 
Label 2 
Label 3 
Pathnames to transfer: 
/MAIN 


: DAILY BACKUP 

: BACKUP DATE 

: NEWMAIL, QUEUE 
DON 

2 

DON 


: DAILY BACKUP 


: ARCHIVE AND PURGE 
: BACKUP DATE 

: NEWMAIL, QUEUE 

DN 

DM 

A d 

: SYSTEM,MAIL 

LAC 


: ARCHIVE AND PURGE 
: (INCLUDES DAILY BACKUP) 
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Canned Operation #3 


Operation Name 
Save Depending On 
Don't Save Name List 
Rename Pathnames 
Do Verify 
Do Purge 
Tape Labels 

Label 1 

Label 2 

Label 3 


Canned Operation #4 


Operation Name 
Save Depending On 
Don't Save Name List 
Rename Pathnames 
Do Verify 
Do Purge 
Tape Labels: 

Label 1 

Label 2 

Label 3 


Canned Operation #5 


Operation Name 
Save Depending On 
Don't Save Name List 
Rename Pathnames 
Do Verify 
Do Purge 
Tape Labels: 
Label 1 
Label 2 
Label 3 
Pathnames to Transfer: 
/MAIN 
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: SOFTWARE DISTRIBUTION 
: (SAVE ALL FILES) 


2 < < 


: (YOUR COMPANY МАМЕ) 
: (YOUR PROD.NAME, VER.) 
: (c) 1982,(YOUR COMP.) 


: VOLUME INTERCHANGE 
: (SAVE ALL FILES) 

:N 

LY 

N 


: VOLUME INTERCHANGE 


: COMPLETE SAVE 
: (SAVE ALL FILES) 
м 
SY 
:N 


: COMPLETE SAVE 
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4.3 Copy Partial Disk to Disk 


The Copy Partial Disk To Disk option copies files.and directory 
structures from one physical device (the SOURCE) to another 
(the DESTINATION). This utility will copy from any unit to any 
unit (including back onto the source unit). The utility can be 
used for the following: 


(1) Copying a single file or directory subhierarchy from one 
device to another. 


(2) Copying from a hard disk of any size to another hard disk. 


4.3.1 How to Use This Utility 

Turn on the file server. Press <Esc> if you want to use the util- 
ity from tape or any disk other than the default disk (#1). 
Whether you use the default disk or not, type «Esc» when the 
"10 seconds" prompt appears; the utility menu will appear. 
Select option D. 

If the file server is currently running, type 


[«Esc- <: password- «Return» ]QUIT « Return 


to reach the utility menu (brackets indicate optional password). 
Select the Copy Partial Disk option (D). 


The first question to be answered is what file or directory struc- 
ture is to be copied: 


ENTER SOURCE PATH 
(USE ‚М FOR ENTIRE UNIT) 
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Enter the full pathname, starting with the drive number or 
volume name, of the file or directory to be copied. For example, 
enter: 


/1 
to copy all of disk unit 1. 
/1/USER/FDR 
to copy all the files in FDR's directory. 
A/USER/FDR/DOS 
to copy only the file DOS (assuming it is not itself'a directory). 


The utility will check the directory and determine the type of 
object you are trying to copy. 


This utility is privileged in that it can override normal password 
and access controls. You will not be refused access to any file 
on the source, or asked to supply any passwords in any path- 
name. (Since the utility can only be run on the file server, this 
does not represent a breach of security). Files created on the 
destination will, with the exception of implicitly created direc- 
tories as noted below, have all the passwords and access rights 
of the originals. 


The escape key can be used to abort a copy in progress. Press- 
ing <ESC> in the middle of a copy will cause the utility to ask 
whether you want the file copy in progréss to complete before 
aborting. 

4.3.2 Copying Single Files 


In the simple case where a file (rather than a directory) has 
been specified, you will be asked: 


ENTER DESTINATION NAME : 
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Enter the pathname that you want for the new file, again starting 
with the drive number or volume name. For example, 
/MAIN/FDR/OLDDOS 


Any subdirectories in the pathname which do not already exist 
will be created. If the file already exists, you will be asked: 


ERASE DUPLICATE (Y N)? 
If you enter "Y" then the existing file will be deleted and the new 
file created in its place. If you say "N", then you get a chance to 


change disks or to гезресйу the name: 


CREATED PATHNAME WILL BE: 1;USERS/FDR/OLDDOS 
OK (Y. №)? 


If you say "Y", then it tries again with the same name. If you say 
"N", then it asks for a new name: 


ENTER NEW PATHNAME OF FILE : 
Enter a new name (on any physical volume) and the utility will 
try again. 
Copying Directory Structures 


in the case where the SOURCE path specifies a directory 
(rather than a file), you will be asked 


ENTER PREFIX FOR DESTINATION FILES 
(USE "/N" FOR ROOT) 


Enter the initial part of the pathname that you wish all of the 
copied directories and files to have. The pathname you specify 
is the name of the directory in which entries will be made for the 
objects at the top level of the SOURCE. 


For example, suppose you have specified /1/USER as the 
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SOURCE and the directory structure is 


:1,USER 
iFILE1 
/DIRECTORY 
/FILE2 
/FILE3 
/FILE4 
...Other files in /1/USER... 


If you specify /2/USER/FDR as the DESTINATION, then the 
resulting file structure will be 


;:2/USER/FDR 
/FILE1 
DIRECTORY 
/FILE2 - 
‘FILES 
FILE4 


The general rule is that files and directories underneath the 
specified SOURCE directory are copied and added to the DES- 
TINATION directory. As usual, directories in the DESTINATION 
pathname may or may not already exist. 


An important particular case of this general rule applies when 
you want to copy ALL of a physical disk and leave the directory 
structure intact. In that case both the SOURCE and DESTINA- 
TION specify only the root directory. For example, using "/1" as 
the SOURCE and "/2" as the DESTINATION will copy all of disk 
1 into the hard disk at the top level. Any existing files or direc- 
tories already at the top level will remain undisturbed, as will the 
name and attributes of the root directory. 


After asking about the source and destination paths, the utility 
will ask some question about how each directory or file is to be 
processed 


ASK ABOUT EACH FILE (Y/N)? 


COPY PARTIAL DISK 


If you enter "Y" then each file or directory will be listed before it 
is copied and you will get a chance to copy it or skip it. If you 
say "№", then all files in the SOURCE structure will be copied 
but in this case the utility asks first how duplicate names should 
be handled. 


ERASE DUPLICATES (Y/N)? 


If you say "Y", then a file which already exists on the DESTINA- 
TION with the same name as the file being created will be 
erased. (If a subtree of files is being copied and a non-empty 
duplicate directory is encountered, the utility will use the existing 
directory rather than aborting because a non-empty directory 
cannot be deleted.) If you enter "N" then you are asked: 


SKIP DUPLICATES (Y/N)? 


If you enter "Y". then any file which cannot be copied because 
the new name already exists will be skipped. 


If you say "N" to both the ERASE DUPLICATES and SKIP 
DUPLICATES questions, then you will be asked about each 
duplicate name as it arises. № you expect no duplicates, the 
prudent course is to answer "N" to both these questions. 


You will now be asked whether the "last backup" dates of the 
source files should be set to today's date (and time) to indicate 
that a backup was made: 


UPDATE BACKUP DATES (Y/N)? 


After these initial questions, the utility will proceed to search the 
SOURCE structure and copy files to the DESTINATION. It 
announces each item name and size as it is processed, for 
example: 


FILE: -1 USER;FILE1,SIZE =212$ 
or 
DIRECTORY: ; 1/USER/DIRECTORY,SIZE -3S 


If you requested to be asked about each item, for files the utility 
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will ask: 

COPY (Y/N)? 
Respond appropriately. If you say "У", then it shows the name 
and size of the file it is about to create and gives you a chance 


to change its pathname: 


CREATED PATHNAME WILL BE: 
/1/USERS/FDR/FILE1,SIZE - 2128 
OK (Y/N)? 


If you say "Y" the file is created and copied but if you say "№" 
you are asked for the new name: 


ENTER NEW PATHNAME OF FILE 
The file is created and you are kept informed of the blocks being 
copied as the transfer progresses, for example: 

COPYING 110 TO 129 OF 1200 
The units are in sectors (256 bytes) and since there are N+1 
sectors in the range from 0 to М, the last message will look 
something like 


COPYING 1180 TO 1199 OF 1200 


If any errors are encountered in creating the file or copying the 
data, the error message is reported and you are asked 


OK TO SKIP IT (Y:N)? 
If you say "N", the utility attempts to create and copy the file 
again because there was not enough room on the destination 
disk. You will be specifically prompted about using a new disk. 
TRY AGAIN WITH NEW DISK (Y/N)? 


When a directory is encountered in the source and you wanted 
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to be asked about each file, then you will be asked separately if 
you (a) want to create the directory now, in which case it will 
inherit all of the passwords and access rights of the original 
directory, and (b) if you want the directory searched. 


CREATE THIS DIRECTORY (Y N)? 
SEARCH THIS DIRECTORY (Y/N)? 


The questions are independent. For instance, you may choose 
not to create the directory but to search it because you will 
rename all of the files that are copied. Conversely you may 
choose to create the directory (with all the passwords and 
access rights copied) but not search it to copy files that it 
currently contains. 


If you do not choose to CREATE the directory when it asks but 
do search it and copy some files with their original names, then 
the directory will be created implicitly in the normal fashion if it 
does not already exist. The difference is that the password and 
access rights will not be copied from the SOURCE, but rather 
implied from the file being copied. 


4.3.3 Copying File Server Bootable Volumes 


Virtual volumes from which the file server can be booted have 
special identification information in the header record. After the 
utility has copied a virtual volume which is identified as the boot 
virtual volume of the source disk. it asks whether you want the 
newly created copy to be the boot virtual volume of the destina- 
tion disk: 


THIS IS THE BOOT PROGRAM OF THE 
SOURCE DISK. SHOULD IT BE THE 
BOOT PROGRAM OF THE DESTINATION DISK (Y/N)? 


If you intend to boot the system from the destination disk, you 


should answer "Y". Enter "N" if the destination disk already has 
an identified virtual boot volume that you do not want to disturb. 
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Note: File server utilities use the term "file" to mean a virtual 
volume as opposed to a file within a virtual volume. When a file 
is being copied, a virtual volume and all files that it contains are 
being copied. 


If a subtree of files is being copied without asking about each 
file and a file which is the boot volume of the source is copied, 
then it will be made the boot volume of the destination without 
asking you about it. This allows an entire volume to be copied 
without asking any questions at all once the copy has started. If 
you later want to change the boot volume of the destination 
disk, you can use the FILDEBUG utility. 


4.3.4 The Simple Special Cases 


The question and answer dialog expected by the utility is difficult 
to explain because there are many variations in the general 
problem of copying substructures of one directory hierarchy to 
another. Although an effort has been made to have it ask the 
relevant questions at the right place, it is important to note that 
there are two simple special cases which require only a few 
answers. 


(1) Copy a single file from one disk to another. 
Specify the full pathname of the file to be copied as the 


SOURCE and the full pathname of the new file. No other 
questions will be asked unless something goes wrong. 


(2) Copy a single file on the same disk. 
The utility can be used to copy or duplicate files on the 


same physical disk by simply using the same root directory 
for both source and destination. 
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4.4 Copy Full Disk to Disk 


This utility menu option is used to make a full copy of a hard 
disk to another already formatted hard disk. 


The sizes of source and target must be identical. 


The utility will permit you to select the volume name of the tar- 
get disk you are creating. This name can be chosen to be the 
name previously recorded on the target, to be the name 
recorded on the source volume, or to be a new name that you 
enter from the keyboard (the "," symbol is not allowed). 


The utility does not preserve any of the files that may already be 
present on the target disk. They are totally replaced by an exact 
image copy of the entire source disk. For a more selective form 
of backup and copy procedures, you should refer to the section 
on Copy Partial Disk which provides more flexible control over 
copying subsections of disks, renaming file server files as they 
are being copied, and preserving the existing files on a target 
disk. 


This utility is privileged in that it can override normal password 
and access controls. You will not be refused access to any file 
on the source, or asked to supply any passwords in any path- 
name. (Since the utility can only be run on the file server, this 
does not represent a breach of security.) 


4.4.1 How to Use This Utility 


(1) Turn on the file server. Press «<Esc> if you want to use the 
utility from tape or any disk other than the default disk (#1). 
Whether you use the default disk or not, type = Esc-- when 
the "10 seconds" prompt appears; the utility menu will 
appear. 
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If the file server is currently running, type 
[«Esc: password = Return>]QUIT<return> 


to reach the utility menu (brackets indicate optional pass- 
word). 


In either case, select option E from the menu. 


(2) You will then see a banner and three lines: 


[Enter «Esc» < cr> to abort at any time] 
READY DISKS FOR COPYING 
ENTER SOURCE DISK NUMBER: 


Enter the source disk unit number. 
When you see the prompt: 
ENTER TARGET DISK NUMBER: 


enter the drive number of the disk you wish to create using 
this utility. 


(3) At this time, the system will read the directory information 
from the two disks you have specified. Several checks are 
made to ensure that these are valid file server disks. Once 
this is completed the utility will display: 


*** Source is: MASTER1 
к Size = 22292 


**« Target is: MASTER.BAK 


(Of course the actual display will show the names of the 
disks you have specified in place of МАЗТЕН1 and 
MASTER.BAK and the sizes will be the corresponding 
actual sizes.) 
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(4) 


(5) 
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Then the following prompt appears: 
KEEP TARGET NAME: MASTER.BAK (Y/N)? 


If you reply "Y^, all the data from the source will be copied 
to the target while preserving the name of the target disk. 


If you reply "N", you will see the prompt 
KEEP SOURCE NAME: МАЗТЕВ1 (Y/N)? 


Replying "Y" will cause the copy to have the same name as 
the original disk being copied. 


If you reply "N" again, you will see the prompt 


ENTER NEW NAME (MAX. 15 CHARS) 


to which you can supply a new name, different from the 
current name of either of the two disks you are copying 


Once you have satisfactorily supplied a name, the utility will 
proceed to copy the entire source to target. It will keep you 
informed of its progress by displaying the current range of 
data it is copying and the total amount to be copied. 


There is nothing more for you to enter, until you see the 
prompt: 


DO YOU WANT TO COPY 
ANOTHER DISK (Y/N)? 


If you wish to exit the utility, enter "N"; otherwise, to begin 
again enter "Y" which will reprompt you as described above 
in step 3. 


It takes approximately three minutes to copy 60 MB and to 
verify the result. 
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How to Abort the Utility 


Whenever the utility requests a reply from you, you may elect to 
abort the current stage of copying and start from the beginning 
of the program. This is done by pressing the <Esc> and the 
« Return keys in succession. 


К is also possible to abort during the data copying phase by 
pressing the <Esc> key (only). If you do so, you must reinitial- 
ize the target disk using the Format Disk option or else recopy a 
source disk to the target using this utility successfully. The infor- 
mation on the target disk is inconsistent if you exit during the 
copying process and can cause a variety of unpredictable 
effects. Never use such a disk without using the Format Disk 
utility option to create a new empty directory. 


POWER DOWN DISK 


4.5 Power Down Disk Drives 
This menu option is used to sequence down a hard disk prior to 
turning off the disk. It is recommended that the following pro- 
cedure be used whenever the disk is to be shut off: 
— Type 
[<Esc> - password> «~ Return ]|QUIT « Return-- 
to quit the file server (brackets indicate optional password). 


Select option F from the menu that is displayed. 


— You will be asked to "Enter number of drive to power down 
(1...4)". Respond with 1, 2, 3, or 4 as desired. 


— The disk heads will be retracted to a landing zone, the 
platter motor will be turned off, and the brake will be ener- 
gized. The File Server Utility Menu will return to the screen. 


Once a disk has been powered down, it will be powered back up 
automatically if a menu option is selected that directs disk input 
or output to the powered down drive. 


If you want to turn the file server off, wait two minutes after the 


power down of disk(s). Then key off the main power switch in 
the lower left hand corner of the front panel. 
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4.6 List Disk Contents 


This utility creates a list of some or all of the files on any of the 
disks attached to that server. It is privileged in that it can over- 
ride normal password and access controls. You will not be 
refused access to any file on the source, or asked to supply any 
passwords in any pathname. (Since the utility can only be run 
on the file server, this does not represent a breach of security.) 


Turn on the file server. Press <Esc> if you want to use the util- 
ity from tape or any disk other that the default disk (#1). 
Whether you use the default disk or not, type <Esc> when the 
"10 seconds" prompt appears. 


If the file server is currently running, type 
[<Esc><password><Return>]QUIT<Return:> 

to reach the utility menu (brackets indicate optional password). 

Select option G from the utility menu that is displayed. 


You will be asked for the name of the output file to contain the 
listing as follows: 


ENTER PATHNAME FOR OUTPUT FILE 
RETURN FOR DEFAULT, ESC TO EXIT 
DEFAULT: .MAIN/SYSTEM/QUEUE/NEW/NNNNNNN.LIST: 


The default pathname is the input queue for the print server, 
and "NNNNNNN" is a timestamp to ensure that the name is 
unique. If you accept the default name by pressing <Return> 
then, when the file server is run, any print server which exam- 
ines the queues on that file server will discover the listing file 
and print it with no further operator action required. If you wish 
to assign a different pathname, perhaps so that a separate pro- 
cessing program can read the listing file, then override the 
default pathname by supplying your own and pressing 
<Return>. If you wish to terminate the utility at this point, or at 
any other prompt for input, type <Esc> <Return:. 


The output file will be created and initialized. If the file already 
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exists, you will be asked for permission to replace it. 
You will now be asked what disk, or part of disk, is to be listed: 
PATHNAME OF TREE TO LIST? 


You may respond with the pathname of any disk or directory 
subtree. Example responses are: 


;MAIN 
;1 
:MAIN/USERS/SMITH 


You are then asked whether you wish to list only the directories 
in the subtree or whether all files, including non-directories, 
should be listed: 

LIST NON-DIRECTORY FILES (Y/N)? 


Note: The term "non-directory files" refers to virtual volumes 
that are not directories. 


If you respond "Y" -:Веѓигп :, then all files will be listed. If you 
respond "N" -: Return >, then only directories will be listed. The 


directory-only list is usually a much shorter summary of disk util- 
ization. 


Finally, you are asked for a title which is to be printed on the top 
of each page of the listing: 


LISTING TITLE: 
Respond with any string, or just «Return-- for no title. 
The utility will now begin examining the directory tree and create 


the listing file. As it executes, a dot is printed on the screen for 
every line added to the output file. 
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4.6.1 The Output Format 


The output of this utility is a virtual volume that contains a 
spooled print request. The first few lines contain instructions to 
the print server, followed by the file listing. There is one line for 
each file in the subtree, indented under the name of the direc- 
tory which contains it. After all the files of a directory have been 
listed, a line starting with "---" summarizes the number of files 
and total space used by the files in that directory. 


The line which describes a file gives the filename, the file type, 
and the size in sectors. (The size does not include a sector for 
each file which contains internal file server information, but that 
sector is counted in the space used by files in the directory.) 
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4.7 Examine/Modify Disk Contents 


This option can be used for a variety of disk maintenance pur- 
poses. The system manager will use it most often to set the 
boot pointer (described in (2) below). The following is an over- 
view of some features of this option which may be useful. 


Turn on the file server. Press <Esc> if you want to use the util- 
ity from tape or any disk other than the default disk (41) 
Whether you use the default disk or not, type <Esc> when the 
"10 seconds" prompt appears. 


If the file server is currently running, type 

[«Esc» «password» «Return» ]QUIT « Return 
to reach the utility menu (brackets indicate optional password). 
Select option H when the utility menu is displayed. 


Input is via a nested series of menus. At the outer level you 
have the choice of: 


F(ile) File system submode allows you to issue a variety 
of file server and other commands to manipulate 
disk structures. 


D(isk) Disk submode is used in conjunction with 
M(emory) submode. № allows sectors to be 
brought in from or written to disk. 


M(emory) Memory submode allows sectors brought into 
memory by the D(isk) submode to be brought into 
memory and changed. 


E(xamine) А combination of the D(isk) and M(emory) func- 
tions, including the ability to interpret the data in 
file system blocks. 
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Warning: Do not use the M(emory), D(isk), or E(xamine) sub- 
modes without the assistance of your network representative. 
Using these utilttes may damage the contents of your per- 
manent disk storage 


I(nfo) Information about buffers within this utility are 
displayed 


Q(uit) Return to the utilities menu. 


The F(ile) submode prompts with "Command?" and has a large 
number of commands available. The HELP command will list 
most of the available commands but you are encouraged to res- 
trict your use to the examples shown below unless you get 
further information from your network representative. Note that 
some of the commands (such as CREATE) differ from their file 
server equivalents in the way in which information is supplied. 


This utility is privileged in that it can override normal password 
and access controls. You will not be refused access to any file 
on the source or asked to supply any passwords in any path- 
name. (Since the utility can only be run on the file server, this 
does not represent a breach of security.) 


F(ile) mode examples 


(1) Renaming a disk volume: 


Command? RENAME ;1 

NEW NAME FOR MAIN (CR TO EXIT): NEWDISK 
DO YOU MEAN TO RENAME THE DISK? Y 

OK 

UNIT 1: NEWDISK? 

Command? 
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(2) Changing the file (system volume) that is to be booted by 
the file server: 


Command? ЗЕТВООТ 1 SYSTEM/FILE SERVER 
OK 


(SETBOOT is one word ) 
Do not delete the volume that the boot pointer currently 


points to until you have reset the pointer to another volume 
using SETBOOT. 


(3) Displaying the pathname of the current boot volume: 
Command? SHOWBOOT <rootname> 
Examples: 
SHOWBOOT /1 
SHOWBOOT /АЁТ 
SHOWBOOT / 


This results in a display of the current boot volume Use 
this utility in conjunction with SETBOOT. 


(4) Deleting a file: 


Command? DELETE /MAIN/USERS/LJS, JUNK 
OK 


(5b) Creating a file: 


Command? CREATE :MAIN/USERS/LJS/NEWJUNK 
SIZE IN SECTORS? 100 

TYPE (SINGLE LETTER)? B 

OK 
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(6) Listing a directory 


Command? LIST MAIN/USERS/LJS 
‚МАМ USERS LJS 
DOCUMENTS T P,SZ-2401S 
MAILT P.SZ 2045 

...Gtc 


(7) Listing a directory (nested) gives a "nested" listing of the 
specified directory. For example: 


Command? LISTN MAIN USERS/LJS 


causes a display of all of the branching subdirectories and 
volumes. If LJS contains the subdirectory "memos", all of 
the volumes in that directory will be listed under "memos." If 
any of the volumes listed in memos are directories, their 
branching volumes will also be listed. 


(8) Crunching (compacting) a file server hard disk requires use 
of several utility options, including this one. The process is 
described in Section 4.12. 


(9) To quit, type QUIT<Return>. 
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4.8 Check Repair Disk Consistency 


This utility is used to verify the consistency of the file system 
data structures and optionally repair them. It can perform the 
following functions: 


— Reads all sectors on the disk, including control and directory 
sectors, user data, and freespace to verify that all sectors 
are physically readable. Data in sectors that can't be read 
without error can be copied into an alternate sector (ignor- 
ing the error). At the same time, the original sector is 
flagged in the disk defect map. 


- Reads and validates all control sectors (headers and file 
descriptors). 


— Reads and validates all directory sectors starting with the 
root directory. 


— Reads and validates all freespace descriptors. 


— Reports any orphaned sectors and optionally adds them to 
the freespace. (Orphaned sectors are those which are nei- 
ther part of allocated files nor on the freelist, and may result 
from a file server crash which occurred while directory infor- 
mation was being updated.) 


— Recovers lost freespace. "Lost freespace" is any area of the 
disk that is not pointed to by either the directory structure or 
the freespace list. Every block in the disk should be 
accounted for by one of these two structures. Lost 
freespace is generally caused when, for some reason, a 
create or delete operation fails to complete. 


Use this option when you suspect that a disk problem exists and 
as a normal part of disk maintenance (such as backup and 
restore operations). 


This utility is privileged in that it can override normal password 


and access controls. You will not be refused access to any file 
on the source or asked to supply any passwords in any 
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pathname. (Since the utility can only be run on the file server, 
this does not represent a breach of security.) 


4.8.1 How to Use the Check Repair Disk Consistency Utility : 


Turn on the file server. Press <Esc> if you want to use the 
utility from tape or any disk other than the default disk (#1). 
Whether you use the default disk or not, type <Esc> when the 
"10 seconds" prompt appears. 


If the file server is currently running, type 
[<Еѕс> «password» «Return» ]QUIT «Return: 
to reach the utility menu (brackets indicate optional password). 


In either case, select option | from the menu that is displayed. 
The utility will ask 


UNIT NUMBER? 


to which you respond with 1, 2, 3, or 4. It then asks whether you 
want the data part of files and/or the unused parts of the disk to 
be read and physically checked: 


THE DIRECTORY AND FREESPACE STRUCTURES WILL 
BE CHECKED. 

ALSO CHECK DATA AREAS FOR UNREADABLE 
SECTORS (Y/N)? 

ALSO CHECK FREE AREAS FOR UNREADABLE 
SECTORS (Y/N)? 


Respond "Y" or "N" to each question. The only reason to 
respond "N" is to save time in the execution of the utility. "N" will 
increase the speed of operation significantly. 


This utility will then begin its examination of the disk. As each 
file is processed, the full pathname will be printed. After all files 
and freespaces have been checked, summary information will 
be displayed. Finally, the program will ask if there are any 
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additional sectors that are defective and that need to be 
assigned to alternates. The time required by the program to 
complete its examination depends upon the total number of files 
and the total number of free extents that separate them. About 
10 MB/minute will be examined. 


If any inconsistencies or structural errors are found, the utility 
will describe the problem and, in many cases, request permis- 
sion to take some corrective action. The general description of 
the possible inconsistencies, the corrective actions, and the 
consequences are beyond the scope of this document. How- 
ever, in the case when the only reported error is orphaned 
blocks (also called "gaps"), it is generally safe to allow the utility 
to add any such blocks to the freespace. 


If errors persist or anything besides "gaps" are reported, contact 
your network service representative. 


In any instance where the data in a defective sector is copied to 
an alternate, the copy may not be completely correct since any 
errors that occur in reading the original sector are ignored. You 
should Verify and correct any errors in the copy using an 
appropriate workstation utility (e.g., if the sector occurs in a text 
file on a virtual volume, use an editor to find and correct any 
errors). 


If the defective sector is a file system header sector, rerun the 
Check/Repair Disk Consistency utility to fix any errors in the 
copy. 


4.8.2 Messages Associated with Remapping a Defective 
Sector 


Sectors are reported as defective when, during a read of that 
sector, there is a failure in a validity test (called a cyclic redun- 
dancy check or CRC) that the disk controller performs. The error 
is reported only after many attempts to read the sector have 
failed. 


When a sector is reported defective, you will be given an 
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opportunity to rewrite the data portion of the sector with zeroes. 
In many cases, there is no defect on the disk surface itself, but 
the data currently recorded has been damaged. After the sector 
has been rewritten, that area of the disk will cause no further 
problems. 


If the process of rewriting (and then rereading) the sector also 
fails the validity test, there may be a surface defect that makes 
that part of the disk unusable. In that case, the utility allows you 
to assign an alternate location for the sector in an area of the 
disk reserved for that purpose. Once the alternate location has 
been assigned and the old location has been marked as defec- 
tive, the sector can be read and written in the usual way with no 
other effect than a slight performance penalty due to additional 
disk-arm motion. 


The process of marking the sector defective includes a "best- 
effort" attempt at copying the data in the bad sector to an alter- 
nate sector. This is accomplished by ignoring any CRC errors 
that occur during the copy. The data in the new sector is there- 
fore likely to be at least slightly incorrect. As a result of this, 
some of the messages listed below will include displays óf some 
of the fields in certain types of blocks, asking you to verify their 
correctness. As an example, suppose that a directory 
(/MAIN/DATA) had two entries in it: JANE and MARK (that is, 
/MAIN/DATA/JANE and /MAIN/DATA/MARK). After the copy, 
the alternate sector may show that the two entries are JAND 
and MARK. You will then be given a chance to change JAND to 
JANE. 


Some errors in the file system blocks will be corrected by the 
utility program itself, so it is very important to continue rerun- 
ning the utility until it detects no more errors. If the defec- 
tive sector is part of a data volume (that is, if it is not a file sys- 
tem internal block) you will need to verify the new copy's 
correctness in some other way. 


For example, suppose that the sector is contained in a IBM PC 
DOS file that has a memo in it. By running an editor or a word 
processor beneath DOS, you will be able to look at that memo 
and correct any errors. If the affected file is not a text file (i.e., is 
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not "human-readable"), it is probably best to delete that file and 
recreate it rather than attempting to fix it. If it is a program file, 
for instance, another (correct) copy of it can be. copied from a 
diskette or another volume. : 


Note that in the user data-sector case, the utility will tell you the 
offset of that sector within the virtual volume. Without under- 
standing the directory structure within that volume (e.g., a СР:М 
format disk) it will be difficult to determine exactly which file con- 
tains the affected sector. One way to check is to look at each 
text file within the volume. In any case, it is important to write 
down the offset of the sector for later use. 


Messages: 
REWRITE IT WITH ZEROES (Y N)? 


Displayed if a bad sector is found during the free-space and 
data-space checking that the utility performs first. Answering 
"yes" to this question will destroy any data in that sector and 
possibly solve the bad sector problem without the necessity of 
assigning an alternate sector. If the sector is in free space you 
should always answer "Y". If it is in data space, answer "М" 
unless you are sure that you will later be able to locate this sec- 
tor within its virtual volume and take the necessary action to 
repair any errors that may occur during the copy. 


ADD TO DEFECT MAP AND ASSIGN ALTERNATE (Y/N)? 
Displayed if the answer to the "Rewrite it with zeroes" question 
was "no", or if the rewrite failed to correct the problem. Мог- 


mally you will want to reassign this sector to an alternate so you 
will answer "Y". 


ASSIGN ADDITIONAL SECTORS TO THE DEFECT MAP (Y.N)? 


After the utility has finished traversing the disk's directory, it 
asks this question. At this point, enter any sector numbers 
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which other programs (е g . the file server or tape backup pro- 
gram) have reported defective. 


| JUST READ THIS SECTOR SUCCESSFULLY. 
MARK IT DEFECTIVE ANYWAY? 


The sector number just entered as a defective sector was read 
without an error. The program is asking if you are sure that you 
want to remap it to an alternate. Check again that the entered 
sector number is correct. If another utility or the file server has 
repeatedly indicated a code $25 (data CRC) error on this sector, 
you may want to mark it defective anyway. 


THAT SECTOR HAS ALREADY BEEN MARKED DEFECTIVE 


The sector number just entered as a defective sector has 
already been entered in the disk defect map. Check again that 
the entered sector number is correct. If it has been entered 
correctly, this means that the alternate sector provided by the 
disk controllér is also defective. Call your customer service 
representative for further instructions. 


THIS IS A FREE LIST DESCRIPTOR 

THIS IS A DATA EXTENT BLOCK 

THIS IS A DATA HEADER BLOCK 

CAN'T VERIFY UNKNOWN FILSYS BLOCK TYPE 


These are information messages about the type of sector being 


remapped. Except for rerunning the utility after all defective sec- 
tors have been entered, no further user action is necessary. 


4-82 


CHECK REPAIR DISK CONSISTENCY 


THIS IS THE VOLUME HEADER FOR UNIT 1. 
UNIT NAME IS MAIN. OK (Y/N)? 


ERROR IN POINTERS TO ROOT DIRECTORY AND FREELIST. 
FIRST DIRECTORY BLOCK IS £X. 

FIRST FREE LIST BLOCK IS #Y. 

CALL YOUR SERVICE REPRESENTATIVE BEFORE RUNNING 
THE FILE SERVER ON THIS DISK 


THE BOOT VOLUME POINTER MAY BE INCORRECT. USE THE 
EXAMINE DISK CONTENTS UTILITY TO CHECK AND SET IT. 


The first and third message indicate that the sector being 
remapped is the volume header (sector: #0). You are being 
asked to verify that the name of this unit is recorded correctly. 
The third message indicates that the pointer to the boot volume 
of this unit (usually /SYSTEM/FILESERVER) may be incorrect 
and that the SHOWBOOT function of the F(ile) option of the 
Examine Disk Contents utility should be used to check it. 


If the second message appears, a serious corruption of the file 
system structure has occurred and no further use of the disk 
should be made before consulting with your customer service 
representative. 


THIS IS A DIRECTORY BLOCK IN <PATHNAME> 
(1) FILE: JAND TYPE=P 
(2) FILE: MARK TYPE=Y 


ANY CORRECTIONS (Y/N)? 
ENTER SLOT NUMBER OF INCORRECT ENTRY (0 TO QUIT). 


The sector being remapped is a directory block. The contents of 
the alternate sector are being displayed so that you can verify 
that the copy occurred correctly. If any fields are incorrect, enter 
the slot number (the number in parentheses) and perform the 
correction. When the necessary corrections have been made, 
enter "О" for a slot number and the corrected sector will be 
rewritten. Be sure to rerun the utility after all defective sectors 
have been remapped. 
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THIS IS A FILE DESCRIPTOR FOR «PATHNAME - 
(1) FILENAME: JAND 
(2) FILETYPE: X 


(3) CREATION DATE: 830101235900 
(4) LAST ACCESS DATE: 830101235900 
(5) LAST MODIFICATION DATE: 830101235900 
(6) LAST BACKUP DATE: 830101235900 


(7) PRIVATE PASSWORD IS SET (* IF THERE IS ONE *) 
(8) GROUP PASSWORD IS SET (* IF THERE IS ONE °) 
(9) PUBLIC ACCESS RIGHTS ARE: RWECDX 
(10) GROUP ACCESS RIGHTS АВЕ: RWECDX 
(11) PRIVATE ACCESS RIGHTS ARE: RWECDX 


(12) THIS VOLUME IS/ISN'T EXTENDABLE. 
ANY CORRECTIONS? (Y/N) 
FIX WHICH FIELD (0 TO QUIT) 


The sector being remapped is a file descriptor block. The con- 
tents of the alternate sector are being displayed so you can ver- 
ify that the copy occurred correctly. If any fields are incorrect, 
enter the field number (the number in parentheses) and perform 
the correction. When the necessary corrections have' been 
made, enter "0" for a slot number and the corrected sector will 
be rewritten. Be sure to rerun the utility after all defective sec- 
tors have been remapped. If the volume is protected 
Execute-Only, Fields 7-11 will not be displayed and they 
cannot be changed. 


CHECK/REPAIR DISK CONSISTENCY SHOULD BE RERUN 
AFTER ALL BAD SECTORS ARE ENTERED, TO FIND ANY 
FURTHER FILSYS BLOCK ERRORS. 


This message will be displayed whenever any file system inter- 
nal blocks are remapped to alternate sectors. There are some 
errors that could occur during the sector copy that can be found 
and fixed only by the utility itself. It is very important when you 
see this message to rerun the utility. The state of the file sys- 
tem structure is not guaranteed to be correct until the utility runs 
- to completion without finding any errors. 
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SECTOR NNNNN IS A DATA SECTOR IN THE VOLUME: 
<PATHNAME> 

AN APPROPRIATE USER STATION UTILITY SHOULD 
BE RUN TO VERIFY THE CORRECTNESS OF THE NEW 
COPY OF THE SECTOR. 


or 


THE DATA WAS COPIED FROM A DEFECTIVE SECTOR, SO 
IT MAY HAVE ERRORS. BE SURE TO CHECK THE VALIDITY 
OF THE COPY USING AN APPROPRIATE WORKSTATION 
UTILITY. 


One of these messages will be displayed whenever the sector 
being assigned to the disk defect map is in the data part of a vir- 
tual volume. Since the utility knows nothing about the contents 
of virtual volumes, some other method must be used to correct 
any errors in the alternate copy of the sector. (See the exam- 
ples at the beginning of this section.) 


*** ERROR READING BLOCK NNNNN -- UNABLE TO DETERMINE 
PATHNAME OF VOLUME THAT SECTOR MMMMM EXISTS IN 


Displayed if, during the process of determining which virtual 
volume a data sector is in, a different data sector is found to be 
bad. To recover from this error, assign sector nnnnn to an alter- 
nate first and then try sector mmmmm again. 


*** BACKPOINTER ERROR IN PATH THAT ENDS IN 
<PARTIAL PATHNAME > 
RERUN THIS UTILITY TO CORRECT THE PROBLEM. 


Occurs when trying to find the pathname of the volume that a 
data sector exists in. An error in the file structure (that cannot 
be fixed by this part of the utility) has been detected. When the 
utility is rerun, it should find and fix a "missing father pointer" 
problem. 
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"** THERE IS AN ERROR IN THE FILE STRUCTURE. 
RUN THIS PROGRAM AGAIN TO CORRECT IT. 


An unexpected type of file system internal block has been found 


during the search for the pathname to a volume containing a 
bad data sector. Rerunning the utility will fix the problem. 


ERROR READING FREESPACE DESCRIPTOR. 
ERROR WHEN REMAPPING SECTOR. CODE IS $XX. 
ERROR READING REMAPPED SECTOR. 


If these errors occur. call your customer service representative. 
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4.9 Format Disk 


Hard disks are shipped already formatted. Under normal cir- 
cumstances there should be no need to reformat a hard disk. 
Do not reformat a hard disk without first contacting your network 
representative. 


The date of formatting is written in the device header. 


In order to prevent accidental erasure of valuable data from the 
hard disk, execution of this utility is password protected. To 
obtain the password and for advice and assistance on the use 
of this utility, contact your dealer or network service representa- 
tive. 


Warning: This utility will destroy all data already on the disk and 
give you a fresh empty disk. Be sure this is what you wish to do 
before formatting a disk. Hard disks are formatted at the factory 
and should not normally be reformatted. 


Alternate sectors of a disk are sectors to which bad sectors can 
be remapped. The Format utility reports how many alternate 


sectors have been used during reformatting. This is the only 
information on alternate sectors provided by any file server util- 


ity. 

(1) Turn on the file server. Press <Esc> if you want to use the 
utility from tape or from any disk other than the default disk 
(#1). Whether you use the default disk or not, type ~ Esc> 
when the "10 seconds" prompt appears. 

If the file server is in operation, type 


[< Еѕс:> < раѕѕмога> < Return] QUIT «Return 


(brackets indicate optional password). In either case, select 
option J when the menu comes up. 


The first prompt is: 


ENTER PASSWORD: 
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(2) 


(3) 
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Call your network support representative for the correct 
password 


The next prompt will be: 
ENTER DRIVE NUMBER (1...4): 


Enter the hard disk number (1, 2, 3 or 4) followed by 
<<Return >. Normally you would not reformat the hard disk 
units; this has been done by Nestar prior to shipping the 
hard disk units to you. 


For PLAN 3000 File Server 5.25" disks that are being for- 
matted for the first time, the Format Disk utility begins with 
a number of prompts documented in Section 4.9.1. Disks 
that are 5.25" are normally formatted the first time by Nes- 
tar. 


You are now prompted with the message: 


DO YOU WANT TO PHYSICALLY FORMAT THIS 
DISK (Y/N)? 


You must reply with "Y" to cause the physical formatting 
information to be written correctly. This will destroy any 
data previously recorded on this disk. 


If Format recognizes the disk you are about to format as a 
previously formatted Nestar volume, it will ask 


ALL DATA ON "name" WILL BE DESTROYED. 
OK (Y/N)? 


where "name" is the existing name of the volume. Enter 
"Y" if you wish to proceed and all contents of the disk will 
be erased. Enter "N" to abort the operation. The program 
will indicate how long it will take to format the disk. Do not 
be disturbed by the lack of screen activity during this 
period. 


Entering "N" in response to the "do you want to physically 


(4) 


(5) 
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format this disk" prompt moves you to the next step. 


After formatting is complete, you will be asked if you wish to 
look at the list of defective sectors that were assigned to . 
alternates: 


THERE ARE N BAD SECTORS ON THIS DISK 
WOULD YOU LIKE TO SEE A DETAILED LIST 
(Y/N)? 


You are now prompted with the message: 


DO YOU WANT TO VERIFY ALL DATA ON THE 
DISK (Y/N)? 


You should verify the correctness of the formatted area of 
the disk, by replying "Y". 


Again the total number of bad sectors will be displayed and 
you will be given a chance to view the detailed list. 


You are now prompted with the message: 


DO YOU WANT TO INITIALIZE THE DISK ROOT 
DIRECTORY (Y/N)? 


Type "Y" and the utility will prompt you with 

ENTER DISK ID: 
Type in a volume name which will be used to identify this 
disk to the file server, and which can be specified by users 
in their disk requests. This name can be up to 15 charac- 


ters long (however, do not include the "/"). 


If the utility recognizes the disk as a Nestar-formatted 
volume, it will ask 


OK TO DESTROY "name" (Y/N)? 


The utility will record the ID name you supply, and will 
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perform other important system initialization tasks in the 
root directory for this disk. During this time the screen will 
display a series of dots, followed by the message: 


DIRECTORY STRUCTURE INITIALIZED. 


Type "N" to the "do you want to initialize the disk root direc- 
tory" prompt if you realize that you have made a mistake 
and wish to skip to the end of the program in order to begin 
again. A disk that does not have correct directory informa- 
tion will not be usable in the Nestar File System. 


Any messages other than those described above should be 


recorded, and if the problem persists, reported to your Nes- 
tar service representative. 


(6) You will now be prompted with the message: 
DO YOU WANT TO FORMAT ANOTHER DISK (Y/N)? 


Answering with "Y" will allow you to format additional disks. 
A reply of "N" returns you to the file server. 


(7) If the disk is a boot disk: After restoring data to the disk 
using the Partial Tape Dump option, select option H (Exam- 
ine Disk Contents) from the File Server Utility Menu to set 
the pointer to the boot volume and then choose option File. 
Then at the COMMAND prompt, type 


SETBOOT //SYSTEM/FILESERVER 


(Note that SETBOOT is one word.) 


4.9.1 Formatting a 5.25" Disk for the First Time 
To format a 5.25" disk for the first time, select the Format Disk 


option from the utilities menu. The diagnostic tape should be 
inserted in the file server tape drive. 
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A banner is displayed, and you will be prompted for a password 
which is available from the network manufacturer. 


The following prompt appears: 
ENTER DRIVE NUMBER (1...4): 


Enter the number of the drive you want to format. The format 
program will ask 


DO YOU WANT TO PHYSICALLY FORMAT THIS DISK? 


You will be prompted for the type of disk to be formatted. The 
disks are identified by manufacturer and model number. There 
is generally an identifying label on the disk itself. 


The program will next initialize the disk defect тар (айт). The 
System prompts: 


PLEASE ENTER MANUFACTURER-SUPPLIED ERROR DATA 
(ENTER « CR- WHEN FINISHED). 


CYLINDER, HEAD, BYTE 


Enter the "cylinder", "head", and "byte" values listed in the 
defect table that you received with your new disk. The defect 
table may be in the form of a sticker on the disk or on an 
attached piece of paper. 


For example, on a 10 MB drive that has three sets of defect 
values, you would enter something like this: 


199,5,7201 
155,4,4980 
98,3,6217 
Press <Return from an empty line when finished. 
Next, you will be asked to verify the data you have entered, set 


by set. It is important that the values be correct. Reply to each 
prompt with a "Y" (yes) or "N" (no). 
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If a value has been entered incorrectly and you reply "N" to the 
verify prompt, you will be given another opportunity to enter the 
value. 
Next, with the prompt 

DO YOU WANT TO ADD ANY MORE DEFECTS (Y.N)? 


you will be allowed to add any more defects that you have for- 
gotten. 


Having completed this value entry, you will see the message 
TRANSFERRING ERROR DATA TO CONTROLLER.... 
If you entered incorrect values, an error message such as 
*** ERROR during format: $33 
is returned. In this case, restart by answering "N" to all further 
prompts until you are asked if you want to format another drive. 
Answer "Y" to repeat the process described above. 
Once you have entered the manufacturer's defect values for 
your 5.25" disk, the remaining disk format procedures are the 
same as for other disks and are discussed in the previous sec- 
tion. 
If the disk is a boot disk: After restoring data to the disk, use 
option H (Examine Disk Contents) from the File Server Utility 
Menu to set the pointer to the boot volume. Choose option File. 
At the COMMAND prompt type 
SETBOOT //SYSTEM/FILESERVER 


(SETBOOT is one word.) You must now reboot before proceed- 
ing with anything else. 
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4.9.2 Formatting a Vertex V185 using Format V2.3b 


To format a Vertex V185 drive for the first time or to reformat it, 
perform the following tasks. 


(1) 


(2) 


(3) 


(4) 


(5) 


(6) 


(7) 


Boot the diagnostic tape. 


Hit the <ESC> key to get the boot menu: 
T - Boot from tape drive 
1 - Boot from drive 1 
2 - Boot from drive 2 


3 - Boot from drive 3 
4 - Boot from drive 4 


Select option T to boot from tape 


The system prompts: 
INSERT DIAGNOSTIC ТАРЕ AND HIT <RETURN> 


Type <Return>. 


The system displays the File Server Utility Menu. Select 
option J. 


The system prompts for a password: 
ENTER PASSWORD: 


The password is "NESTAR" (uppercase is mandatory). 


The system prompts: 
ENTER DRIVE NUMBER (1..4): 


Enter the word "DEBUG". 
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(8) The same prompt appears (ENTER DRIVE NUMBER 
(1..4):). This time enter "1". 


(9) The system prompts: 
DO YOU WANT TO PHYSICALLY FORMAT THIS DISK (Y/N)? 
Type "Y". 
(10) The system prompts: 
OVERWRITE EXISTING DEFAULT MAP (Y/N)? 
Type "Y". 


(11) The system displays eight different drive types, then 
prompts. 


ENTER DRIVE TYPE: 


Enter "0". 


(12) The system prompts: 
ENTER NUMBER OF HEADS: 


Enter "7". 


(13) The system prompts: 
ENTER NUMBER OF CYLINDERS: 


Enter "1166". 


(14) The system prompts: 
ENTER CYLINDER TO LOWER WRITE CURRENT: 


Enter "О". 
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(15) The system prompts: 
ENTER CYLINDER TO START PRECOMPENSATION: 


Enter "О". 


(16) The system prompts: 
ENTER LANDING CYLINDER: 


Enter "О". 


(17) The system requests the manufacturing defect data. This 
information is on top of the drive. Enter the data and 
< Return-. 


(18) The system will review the defect data you entered, line- 
by-line, allowing.you to correct any errors. After this review, 
the system starts formatting the drive. A message appears 
telling you how long it will take to format the drive. 


(19) During the course of the format, the system may find addi- 
tional bad sectors. The system will display how many there 
are, then ask if you want a detailed list; type "Y" or "N". 
Once you have reviewed the list (if you entered "Y"), the 
system asks if you want to enter more defects. If you 
respond with "Y", the system will prompt you for data on the 
additional sectors. Enter the appropriate information. 


(20) When the drive has been formatted, the system prompts: 
DO YOU WANT TO VERIFY THE DISK (Y/N)? 


Enter "Y". 
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(21) Additional bad sectors may be encountered during the 
course of the verify process. The system will display how 
many there are. then ask if you want a detailed list; enter 
"Y" or "N". Once you have reviewed the list (if you entered 
"Ү"), the system asks if you want to enter more defects. If 
you respond with "Y", the system will prompt you for data 
on the additional sectors. Enter the appropriate informa- 
tion. 


(22) The system prompts: 


DO YOU WANT TO INITIALIZE THE DISK ROOT 
DIRECTORY (Y/N)? 


Enter "Y". 


(23) The system prompts: 
DO YOU WANT TO FORMAT ANOTHER DISK (Y/N)? 


Enter "М". 


(24) Enter «Return- to get back to the File Server Utility Menu. 
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4.10 Modem Оп. Off Setup 


This utility allows you to use a remote terminal via modem as a 
file server console. (See the PLAN Series Physical Planning 
and Installation Manual for information on setting up a console 
or terminal and Section 2.2 of this manual for setting up 
modems.) 


The file server MODEM ON/OFF command (Chapter 3) serves 
the same purpose as the enable/disable functions of this utility. 


To use this utility, turn on the file server. Press any key if you 
want to use the utility from tape or from any disk other than the 
default disk (#1). Whether you use the default disk or not, type 
«Esc» when the "10 seconds" prompt appears. The utility 
menu will appear. 


If the file server is running use the MODEM ON/OFF command 
to enable or disable the modem. 


If no file server console is present, enter the command from ап 
FSCMD file created at a user workstation (Section 2.3.1). 


Select menu option L (PLAN 3000) or option M (PLAN 4000 and 
5000). 


The utility will display a sub-menu: 

(1) ENABLE MODEM 

(2) DISABLE MODEM 

(3) SEND COMMANDS TO MODEM 

WHICH OPTION? 
If you choose Option 1 the modem port will be enabled. The 
console will slow down to about 1200 bps and display the mes- 


sage: 


MODEM IS ENABLED 
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Option 2 will disable the modem, speed the console up to 9600 
bps. and display: 


MODEM IS DISABLED 


Transactions in this mode occur at an effective rate of 1200 
baud because of modem transmission speeds, even though the 
local console is normally 9600 baud. This is only true while the 
phone connection is in effect. Speed reverts to 9600 baud when 
the connection is broken, even if MODEM OFF is not issued. 
The baud switch on the console can stay at 1200 and need not 
be changed. 


Option 3 allows you to send commands and receive responses 
from the modem. (Refer to the modem's instruction manual for 
the form of these commands and responses.) К will also 
automatically enable the modem if it is not already enabled The 
following message will be displayed, after which you can type 
commands to the modem 


CHARACTERS TYPED WILL BE SENT TO THE MODEM. 
RESPONSES WILL BE DISPLAYED. 

TYPE - ESC - TO END THIS MODE AND RETURN 

TO MAIN MENU. 
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4.11 Full Tape Dump Restore 


This option is not available on the PLAN 3000 File Server. For 
PLAN 4000 and 5000 File Servers, it is shipped on the backup 
tape for file server software as option L on the utility menu. 


Tape Cartridge and Tape Drive 


This utility is used to create backups of network hard disks on 
the cartridges and to restore that data to the hard disks. The 
program is also used, sometimes in conjunction with other utili- 
ties, to recover from hard disk crashes. 


Although this utility is faster than a Partial Tape Dump (Section 
4.1), the Partial Dump utility is used more frequently for full disk 
backups (despite the name "partial'. See Section 4.1.3 for 
more on the strategy involved in using these two utilities. 


Note: Tapes made with the Full Tape Dump option and those 
made with the Partial Tape Dump option are not compatible with 
each other. 


The system manager should include a high-speed cartridge tape 
for backup use. The drive uses 1/4-inch, 450 foot tape car- 
tridges which hold 45 Megabytes (or, in some cases, 60 MB) of 
formatted data. 


The tape drive operates in the "streaming" mode, writing 45 MB 
of data onto one cartridge in less than 12 minutes. A part of the 
file server station, the tape drive requires less than 18 minutes, 
for example, to create a backup tape for data on a 60 MB hard 
disk, using two tapes on a 45 MB drive (or one tape on a 60 MB 
drive). 


The streaming drive checks data as it is being recorded on tape. 
Checking is accomplished by a system of double tape heads. 
As one head writes the data, a second head reads and verifies 
the newly written data. If an error is detected, a signal is given 
to rewrite the block in question. 
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Preventive maintenance for these tape drives consists of clean- 
ing the read write head assembly and tape-hole sensor assem- 
bly (Figures 4-1, 4-2 4-3; Section 4.2). Clean these assemblies 
after every eight hours of actual tape motion (e.g., after two Par- 
tial Tape Dumps of a portion of the disk, or one complete Partial 
Tape Dump). Clean the drive after an initia! pass of a new car- 
tridge ‚ог. if new cartridges are used exclusively, after every two 
hours of tape motion). Use a clean lint-free swab and an IBM or 
equivalent head-cleaning solution. An Isopropyl alcohol solution 
can also be used. Care should be taken to ensure that excess 
Cleaner is not applied to adjacent parts and that all residue s 
completely removed prior to insertion of media. 


Head cleaning should be performed with the power off. 


4.11.1 Making or Restoring Backups 

Turn on the file server. Press <Esc> and "Т" to use the utility 
from tape. Type «Esc» when the "10 seconds" prompt 
appears. When the utility menu appears, select option L. 

If the file server is currently running, type 


[<Еѕс> « password» « Return» ] QUIT «Return > 


to reach the utility menu (brackets indicate optional password). 
Select the Full Tape Dump/Restore option. 


Note: Pressing «Esc» «Return» to any prompt aborts the pro- 
gram. 


The following prompt appears: 


ENTER HARD DISK UNIT NUMBER (1,2...): 
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Enter the unit number of the disk to be dumped or restored. 
The current date and time and a menu of choices will appear: 


02-JUN-1983 15:29:40 


D(UMP TO TAPE) 
R(ESTORE TO DISK) 
V(ERIFY TAPE AND DISK) 
T(ENSION) TAPE 
H(EADERS) 

Q(UIT) 


WHICH? 
The T(ension) Tape option winds and unwinds the tape to adjust 
its tension. This takes six minutes and should be done for tapes 
that have been in storage for more than a few weeks, or if a 


high error rate is occurring 


The H(eaders) option displays information about hard disks (as 
specified above) and the backup tape cartridge. The format is 


DISK "EXAMPLE", SIZE 63840 SECTORS 
LAST BACKUP WAS 04-JUN-1983 18:27:47 


and, after asking if the tape is ready: 


THIS IS TAPE #1 OF DISK "EXAMPLE" 
MADE ON 15-MAY-1983 11:53:27 


The V(erify tape and disk) option will cause Tape Dump to read 
the backup tape and disk simultaneously and compare their 
contents. A difference between the two will indicate that: 


(1) The data on the disk has been changed or damaged since 
the dump to tape was made, or 


(2) There is something wrong with the tape copy. 
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The verify option can be used to discover if a portion of the hard 
disk or tape cartridge contents has been changed or damaged. 


The verify option is also available for use after the dump or 
restore has been completed to assure that the procedure has 
been completed correctly and that the contents of the hard disk 
and tape are identical. 


Dumping from Hard Disk to Tape 


Pressing D = Return for dump in response to the prompt 
above causes the utility to display 


DISK "EXAMPLE". SIZE 63840 SECTORS 
LAST BACKUP WAS 04-JUN-1981 18:27:47 


Here the source disk is named "EXAMPLE". The disk is 63840 
sectors in size. 


INSERT TAPE # 1 OF DISK "EXAMPLE" 
IS TAPE READY (Y/N)? 


More than one cartridge will be necessary to back up a hard 
disk. The exact number of cartridges will depend upon the capa- 
cities of the tape and hard disk in question. 


A response of "N" to the prompt will cause the prompt to be 
repeated. 


You will next be asked if you want to verify the dump. Verify 
causes the utility to compare tape to disk after the dump is com- 
plete. Any differences between hard disk and tape will generate 
an error message. 


Whether you type "Y" or "N", the utility will proceed to copy the 
contents or the hard disk onto tape, displaying the words 


DUMPING... 


If the write-protect screw on the tape cassette has been turned 
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to "SAFE ', no dump trom disk to tape is possible and an error 
message will be returned 

TAPE IS WRITE PROTECTED 
When a hard disk is being dumped, the utility will prompt 


THIS TAPE IS FULL 
REMOVE IT AND PUT IN ANOTHER ONE 


after a portion of the hard disk has been dumped. Remove the 
cartridge and insert another, which will become tape #2 of the 
dump. 


Note: The write-protect screw on the tape cartridge should be 
turned to SAFE immediately after a backup has been made 


If the Verify option has been specified, the program will display 
VERIFYING... 

after the successful dump of each tape. If tape and hard disk 

data agree, the utility will go on to the next tape or redisplay the 


option menu. To exit, type "Q". 


To dump from another hard disk, quit and re-enter the program. 


4.11.2 Restoring a Hard Disk from Tape 
Responding to the prompt 


D(UMP TO TAPE) 
R(ESTORE TO DISK) 
V(ERIFY TAPE AND DISK) 
T(ENSION) TAPE 
H(EADERS) 

Q(UIT) 


WHICH? 
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with В «Return--, causes the utility to display 


DISK "EXAMPLE", SIZE 63840 SECTORS 
LAST BACKUP WAS 09-DECEMBER-1985 18:27:47 


INSERT TAPE #1 OF DISK "EXAMPLE" 
IS TAPE READY (Y/N)? 


Entering "N" will cause the prompt to be repeated. With a "Y", 
the utility will verify that the tape is a dump of the disk and ask 


OK TO RESTORE? 


Error messages that may appear at this point are described 
below. A "Y" causes the program to restore the contents of the 
cartridge tape to the designated hard disk (destroying any infor- 
mation already on the disk). As this is accomplished, the mes- 
sage 


RESTORING... 


will appear on the screen to indicate read/write activity on tape 
and disk. The number of cartridges required to restore a. hard 
disk will depend upon the capacities of the cartridges and hard 
disks in question. Data will be restored at the rate of 5 
MB/Minute. If tape and hard disk data agree, the utility will go 
on to the next tape or redisplay the option menu. To exit. type 
"а". 
If the Verify option has been specified, the program will display 
VERIFYING.... 
after the successful restore from each tape. If tape and hard 
disk data agree, Tape Dump will go on to the next tape or 
redisplay the option menu. If the V(erify) option was not selected 
earlier, it can be selected when the menu is redisplayed. To 
exit, type "Q". 


To restore to another hard disk, quit and re-enter the program. 
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Errors encountered during the verify procedure are discussed 
below. 


4.11.3 Error Messages in the Tape Dump Utility 


During the Restore procedure, one of three different error mes- 
sages may appear on the screen after the user has responded 
to the question "IS TAPE READY?" with "Y". 


1. THIS IS TAPE # 1 OF DISK "EXAMPLE" 
MADE ON 15-MAY-1985 11:53:27 
THIS IS A DUMP OF A DIFFERENT SIZE DISK 


2. THIS IS THE WRONG TAPE NUMBER. 
3. THE TAPE IS NOT A DUMP OF THIS DISK. 


The first message is displayed if tape and disk sizes are not the 
same; the second if the #2 tape is inserted for the restore 
before the #1 tape; the third if disk and tape have different 
names. Errors #1 and #2 are fatal and the program will prompt 
for another tape. For error #3, the utility will continue as 
described above, asking 


OK TO RESTORE (Y/N)? 


If "Y" is typed, the name of the disk being restored will be 
changed to the name on the cartridge, and the data on the tape 
will be restored to the disk. 


If during the verify procedure the utility detects any difference 
between tape and disk data other than in their headers, the pro- 
gram will display a message like the following: 


*** TAPE ERROR: 

NO DATA DETECTED 
UNRECOVERABLE DATA ERROR 
BLOCK IN ERROR NOT FOUND 


This error signifies that a blank space or unreadable data exists 
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on the tape in a location where data is expected. It is most 
often encountered when a tape has been partially (or never) 
written. When a message like this appears, the utility will abort 


Remember to record exact error codes and messages when 
they appear. These will prove useful to your network service 
representative. 


4.11.4 Recovering from a Catastrophic Hard Disk Crash 


In the event that the system hard disk is inadvertently erased or 
reformatted, or should the portion of it containing the system 
utilities become unreadable, it will be necessary to examine the 
disk using the Check Disk Consistency utility to determine the 
extent of the damage. In the case of partial loss of disk con- 
tents, the Partial Tape Dump/Restore option will be used to 
restore lost volumes. 


If disk utilities are lost, it will be necessary to reboot the file 
server from tape to use them. 


Never reformat the hard disk and restore the lost hard disk files 
from a backup tape using the Full Tape Dump/Restore utility 
without explicit instructions from your local network service 
representative 


4.11.5 How to Write-Protect a Cartridge 


Locate the screw on the cartridge with an arrow on it. Turn the 
screw until the arrow points to the word "SAFE". 


4.11.6 Backup Strategy 


For information on backup strategy, see Section 4.1.4. 
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4.12 Crunching a Hard Disk 


Crunching a disk is the process by which all of the freespace on 
the disk is packed into one contiguous area. 


As virtual volumes are deleted and others added, the disk may 
become fragmented In other words, the freespace on the disk 
eventually becomes split into many small areas that cannot be 
allocated as a single volume. Compaction, or crunching 15 the 
cure for fragmentation. 


Doing a LIST .MAIN will suggest whether or not a disk needs to 
be crunched. At the end of the list, the amount of freespace and 
the size of the largest freespace section is given A newly 
created volume can be no longer than the size of the largest 
freespace section. 


Example: 
13175 sectors are free but the largest freespace section is 
only 400 sectors. A volume at this time can only be a little 
less than 400 sectors (the system takes a couple of sectors 
for housekeeping). 


4.12.1 How to Crunch 


There is no one utility that crunches a disk. Crunching requires 
the use of several utilities. 


(1) Boot from the current version of the Diagnostic tape (also 
known as the boot tape). 


(2) Using option B (Partial Tape Dump/Restore) of the File 
Server Utility Menu, make a complete backup of the disk 
you wish to crunch (e.g., MAIN). 
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(3) 


(4) 


(5) 


(6) 


Warning: Be sure to verify Without verifying а backup 
there is absolutely no guarantee that the data on the tape 
can be restored back to disk. Without a backup, all data on 
the disk to be crunched will be lost. 


The specifics of running this utility are in Section 4.1. 


Using option J (Format Disk) of the File Server Utility Menu, 
initialize the root directory. The specifics of running this util- 
ity are in Section 4.9 It is not necessary to physically for- 
mat the disk; reinitializing the directory structure is all that is 
required. 


Using option B again, restore the tape you just made. 


If the disk was the file server's boot disk, continue through 
step six as the pointer to the boot volume must be set 
Otherwise, you may stop here; simply reboot your file 
server. 


Use option H (Examine Disk Contents) from the file server 
utility menu to set the boot volume. Choose option F)ile At 
the COMMAND prompt type 

SETBOOT //SYSTEM/FILESERVER 


(Note that SETBOOT is one word.) 


Reset the file server and boot from hard disk. The crunch- 
ing process is complete. 
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Error Codes 


A.1 Introduction 


Errors in this Appendix are listed in the following order: 


Section 


A.2 
A.2.1 
A.2.2 
A.2.2.1 


A.3 


A.3.1 


A.3.2 


A.4 


A.5 


-Error Type 


Hard Disk and Tape Errors 

Hard Disk and Tape Error Codes 
Device Error Subcodes 

Hard Disk Device Subcodes 


Errors While Booting the File 
Server 


Errors While Booting From 
Hard Disk 


Errors While Booting From Server 
Boot Tape 


System Errors 


File Server Error and Information 
Messages 
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A.2 Hard Disk and Tape Errors 


Disk error codes are reported in hexadecimal by the file server 
(the file server program and the various offline utilities). They 
consist of two parts: 


(1) A disk error code, described in the Disk Error Code table in 
A.2.1. 


(2 A device subcode, which is device dependent and 
describes the details of the error. 


You should contact your service representative immediately 
upon discovery of a hard disk error. Record both the error code 
and the subcode for your service representative. 


A.2.1 Hard Disk and Tape Error Codes 


CODE 
(HEX)DESCRIPTION 


00 GOOD EXECUTION 
01 GOOD EXECUTION; 
SEEK RETRY AFTER SEEK FAULT ERROR 
02 GOOD EXECUTION; 
SEEK RETRY AFTER CYL MISMATCH ERROR 
04 GOOD EXECUTION; 
DATA RETRY AFTER ID CHECKSUM ERROR 
05 GOOD EXECUTION; 
DATA RETRY AFTER CRC ERROR 
08 TAPE READ OPERATION COMPLETE, 
TERMINATED BY FILE MARK 
13 DRIVE SEEKING 
18 REWIND;POSITION COMMAND IN PROGRESS 
19 ERASE TAPE;POSITION COMMAND IN PROGRESS 
1А  RETENSION;POSITION COMMAND IN PROGRESS 
1B ADVANCE FILE MARK; 
POSITION COMMAND IN PROGRESS 
1С TRANSPARENT BACKUP IN PROGRESS 
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TRANSPARF NT RESTORE IN PROGRESS 
DISK DRIVE NOT PRESENT 

SEEK FAULT 

CYLINDER MISMAT^H ERROR 
SECTOR NOT FOUND 

ID CHECKSUM ERROR 

DATA CRC ERROR 

DISK WRITE PROTECTED 

INVALID CONTROLLER COMMAND 
INVALID DISK DRIVE 

INVALID HEAD 

INVALID CYLINDER 

INVALID SECTOR 

INVALID DRIVE ID 

INVALID SECTOR SIZE 

(OTHER THAN 128,256, OR 512) 
DISK OVERRUN (MAX CYLINDER) 
BAD SECTOR DETECTED BY 

CRC VERIFY ROUTINE 

DEFECT EXISTS 

DEFECT MAP FULL 

NO DEFECT MAP 

NO SPACE FOR ALTERNATE 
DEFECT NOT FOUND 

TAPE DRIVE NOT PRESENT 

TAPE CARTRIDGE WRITE PROTECTED 
FILE MARK DETECTED 

BLOCK IN ERROR NOT FOUND 
HARD DATA ERROR 

CARTRIDGE NOT IN PLACE 

END OF TAPE 

TAPE NOT ONLINE 

TAPE RESET OCCURRED 
BEGINNING OF TAPE 

NO DATA DETECTED 

ILLEGAL COMMAND 

(TO TAPE DRIVE FROM CONTROLLER) 
INVALID COMMAND WITH 

TAPE WRITE MODE SET 


- INVALID COMMAND WITH 


TAPE READ MODE SET 


ERRORS 


73 ТАРЕ NOT АМАН ABLE 
(CURRENTLY BEING USE D IN XPARENTCOM) 
80 CONTROLLER RESET HAS OCCURRED 
FO МО COMMAND; AWAITING ACKNOWLEDGEMENT 
F4 TRANSPARENT COMMAND NOT COMPLETE 
F8 NO TRANSPARENT COMMAND IN PROGRESS 


A.2.2 Device Error Subcodes 


When a device dependent error occurs, a subcode is displayed 
in hexadecimal; interpretation of it depends on the device type. 


Each subcode is a single byte of which bits represent various 
conditions. Several bits may be on simultaneously so that their 
sum represents the total subcode. Not all bits indicate errors; 
some are simply status information. A device error subcode of 0 
indicates no subcode is given for the device causing the error 
A conversion table for decimal, hexadecimal, and binary 
numbers appears in a separate appendix. 
A.2.2.1 Hard Disk Device Subcodes 
PLAN 4000 File Server 

me and Description 
$01 Ready 
The drive is up to speed, servo system is locked onto a servo 
track, and the unit is in a state to read, write or seek. 


$02 Seek Complete 


The bit is set when seek operation is completed. 
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$04 Seek Fault 

This bit indicates that a fault was detected during a seek opera- 
tion. 

$08 Cylinder Zero 


The access arm is positioned over cylinder O. 


$10 Busy 


The drive is in the process of executing a command. 


$20 Drive Fault 


A fault was detected by the drive error monitoring circuitry. 


$40 Write Protect 

The drive selected is write protected. Write protection is set by 
switches in the drive or when the drive is not sequenced up. 

$80 Command Reject 


A control or Register Load Command was received while the 
drive was not ready, or an undefined command was received. 


A-5 


ERRORS 


PLAN 3000 File Server 

Value Name and Description 

$01 Reserved for disk tape controller. 
$02 Reserved for disk. tape controller. 
$04 Reserved for disk tape controller. 


$08 Reserved for diskitape controller. 


$10 Drive Fault 


A fault was detected by the drive error monitoring circuitry. 


$20 Seek Complete 


The bit is set when seek operation is completed. 


$40 Cylinder Zero 


The access arm is positioned over cylinder 0 
$80 Ready 


The drive is up to speed, servo system is locked onto a servo 
track, and the unit is in a state to read, write or seek. 
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A.3 Errors while Booting the File Server 


A.3.1 Errors while Booting from Hard Disk 

If a hardware error occurs during boot, an attempt is made to 
diagnose the problem and report it. The following table is a list 
of the messages and their meaning. 

All errors that occur while booting from hard disk are serious 
and should be reported to your service representative immedi- 
ately. 

Disk drive not attached to PIC. 

Indicates the Peripheral Interface Card (usually in slot 3 of the 
card cage) is not communicating with the controller. Possible 
causes are a damaged PIC, cable, or disk controller. 


Drive Error when identifying drive. Code is $xx. 


A hard disk error occurred while accessing the boot drive See 
Section A.2.1 for list of the error codes and their meanings. 


$36 indicates that the drive is unformatted. 


Drive Error while reading boot volume. Code is $xx. 

A hard disk error (error code xx) occurred while reading the boot 
volume //SYSTEM/FILESERVER. See Section A.2.1 for a list of 
the error codes and their meanings. 

PIC missing or not working. 

Indicates the file server could not access the PIC (usually in slot 


3 of the card cage). The PIC is not present in the machine or is 
not working. 


A-7 


ЕВАОВ$ 


Disk sector 0 is not initialized. 

The disk does not have a directory structure placed upon it. Indi- 
cates corruption of the disk structure. 

Disk boot volume pointer not set. 


Indicates there is no boot volume set for this drive. 


A.3.2 Errors while Booting from Server Diagnostic Tape 

If a hardware error occurs during the boot process, an attempt 
should be made to diagnose the problem and to report it. The 
following is a list of the messages and their meanings. 

Tape is not a Server Diagnostic tape. 

Indicates a tape of the wrong type was inserted in the drive. 
Only diagnostic boot tapes, not backup tapes, can be used to 
boot the server. 

Version of the Diagnostic tape must be Version 2.0 or later. 
Indicates an attempt was made to boot from a tape older than 
the boot ROM. 

Checksum error on Diagnostic tape. 

Indicates an error while reading tape. Possible causes are a 
damaged tape or a defective drive or controller. 

Error during tape read. Result is $xx. 


Indicates an error occurred while reading the boot tape. See 
Section A.2.1-for a list of the error codes. 
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A.4 System Errors 


If the file server detects a run-time error, the following message 
is displayed 


s SYSTEM ERROR =" 
error type _ 


System stack is. ii jijjjjjj КККК mmmm nnnnnnnn 
Hit return to reboot server... 


"Error type' is a message describing the error. 

If this occurs contact your network service representative 
immediately. You should also record the full contents of the file 
server's console (for your service representative's use). Then 
reboot the file server and check the consistency of the disk (see 
Section 4.9) before allowing the file server software to execute. 
A.5 Error and Information Messages 

When the file server receives a file server command from a user 
station, it executes the command if possible and, in any case, 
returns two variables: 


— return code (an integer between 0 and 300) 


— return message, such as OK, ILLEGAL COMMAND, or 
TYPE=IBM PC DOS 


Messages are of several types: 
— information, such as OK, IN USE, TYPE=BINARY 


— user errors such as syntax errors or attempting to access а 
network file without the necessary access rights 


— system errors such as memory full or disk full; these should 
be reported to the system manager. 


In this list, messages are classified as: 
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- general syntax 
- pertaining to a specific command 
— System errors 


file system errors 


General Syntax (0-19) 

0,OK 

(Not an error.) The command was syntactically correct and was 
executed without error. 

1,ILLEGAL COMMAND 

The command verb cannot be recognized or cannot be exe- 
cuted from this user station operating system environment. The 
command verb is the first word' of the command, and must be 
separated from the rest of the command with one or more 
blanks. 

2,NAME PARAMETER REQUIRED 

The first parameter of the command must be a non-null path- 
name or lockname. 

3,UNRECOGNIZED PARAMETER 

A keyword parameter was not recognized. Check the spelling 


carefully and make sure that it is properly separated from the 
previous and following items with commas. 


A-10 


ERRORS 


4,ILLEGAL DRIVE IDENTIFIER 


In all environments except PC DOS, a drive ID must be speci- 
fied with "D" followed by an integer in the range supported for 
your environment, for example D4. For PC DOS, the drive iden- 
tifier should be in the range "A:" to "Z:". 


5,ILLEGAL STATION NUMBER 

A station number must be specified as a two-digit hexadecimal 
number preceded by "$" in the range $01 to $FE for example 
$2D. 

6,MISSING PROTECTION PARAMETER 

A PROTECT command has been issued without at least one of 
the following keyword parameters: PRVPW, GRPPW, PRVACC, 
GRPACC, PUBACC. 

7,PARAMETER APPEARS TWICE 

A keyword parameter appears more than once in a single com- 


mand. There can only be one occurrence of each keyword 
parameter, even if multiple occurrences have the same value. 
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8,ILLEGAL TYPE PARAMETER 


The "Т=" value is not one of the legal volume types. It must be 
one of the following: 


P (Apple // Pascal) B (binary) 

D (Apple // DOS) S (system) 

C (Apple // CP/M) Y (directory) 

3 (Apple /// SOS) T (text) 

Ц (IBM PC p-SYSTEM) | (IBM PC DOS) 

R (server request) X (user defined) 
Example: T=P 


9,COMMAND TOO LONG 


A file server command must be no longer than 80 characters. 
In unusual cases where this is a problem, long commands can 
often be shortened by using a default directory, or by assigning 
access rights in a subsequent PROTECT command. 


10,PARAMETER TOO LONG 


The new name given as the second parameter of the RENAME 
command, the password, or the INIT VOLNAME parameter 
must be no more than 15 characters long. Remember that 
RENAME changes only the last name in the sequence of names 
which constitute a pathname. If you wish to change the name 
of a directory, give the pathname of the directory itself as the 
first parameter of RENAME. 
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11,ILLEGAL PROTECTION PARAMETER 


The value of the PUBACC, GRPACC, or PRVACC protection 
item is incorrect. The value must be some combination of the - 
letters RWECDX (read, write, erase, create, delete and exe- 
cute), or may be nul. For example, GRPACC=RW ог 
PUBACC=. 


13,NUMBER OUT OF RANGE 

The number was less than -(2`31) or bigger than (2°31)-1. 
Number may be specified in decimal, or in hexadecimal pre- 
ceded by "$". For examples, 42, $1АЗ. 

19,HELP FILE NOT FOUND 

There is no HELP file for the word used as an operand of the 
HELP command. Use the HELP command without any parame- 
ters to see what the possible HELP parameters are. (The sys- 
tem manager has the option of removing all HELP files to save 
space.) 

Create (20-25) 

20, TYPE PARAMETER REQUIRED (T=) 


The type parameter was missing, for example T - D. 
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21,SIZE OUT OF RANGE 


The legal SIZE ranges are 


Type Min (blocks) Max (blocks) 
Y 1 32 
S 1 contiguous 


free space 
D 0 16383 


All others 0 contiguous 
free space 


Each block is 512 bytes. Other units that can be specified are C 
(characters), and K (1024 bytes). If the units are omitted, B 
(512-byte blocks) is assumed (one block - two sectors). For 
example, SIZE = 280, SIZE -20008S. 


23,SIZE PARAMETER REQUIRED WITH T-B 

The SIZE or LENGTH parameter must be specified to create a 
binary volume. The size may be an overestimate of the size of 
the data to be BSAVEd into the volume, but it must not be less. 
Delete (27-29) 

29,CURRENTLY MOUNTED OR DEFAULT DIR 

You cannot delete a volume which is currently mounted by any 


station, or which is the default directory (see the SET DIR com- 
mand) of any station. 


ЕВАОЯ$ 


Mount (30-34) 

30,DRIVE REQUIRED 

You must specify what drive the volume is to be mounted on. 
For example, D4. 

31,IN USE 

The volume you asked to mount is in use by another station. 


You are therefore denied Exclusive or Update use of that 
volume. 


32,IN EXC USE 

The volume you asked to mount is in exclusive use by another 
station. You are therefore denied any use of the volume. 

33, VOLUME NOT INITIALIZED 

An attempt was made to mount a volume that was not created 
using a file server CREATE command. 

34,RW NOT ALLOWED ON DIRECTORIES 


You are not allowed to mount a directory (T - Y) volume for write 
access. 

Unmount/Remount (35-39) 

35,DRIVE OR "ALL" REQUIRED 

You must specify a drive number or "ALL" in the UNMOUNT or 


REMOUNT command. For example, UNMOUNT D;, 
UNMOUNT ALL. 
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36,NOT CURRENTLY MOUNTED 

The drive number specified in the UNMOUNT or REMOUNT 
command does not have a virtual volume mounted on it by the 
file server 

Lock/Unlock (40-49) 


40,ILLEGAL LOCK NAME 


A lock name must be 1 to 15 characters long. 


41,IN USE 

The lock name specified is in use by another station. You are 
therefore denied exclusive use of the lock. 

42,IN EXC USE 

The lock name specified is in exclusive use by another station. 
You are therefore denied any use of the lock. 

43,<lock уаше`- 

(Not an error.) READLOCK, WRITELOCK, LOCK+ AND LOCK- 
commands return the previous lock value. 

44,LOCK VALUE OUT OF RANGE 


The result of a LOCK+ or LOCK- command can not be 
expressed as a 32 bit integer. 


ERRORS 


45,LOCK NOT HELD 


The lock name specified is not currently held by your station. 


46,LOCK HELD BY MAXIMUM USERS 

LOCK command failed because current number of lock holders 
equals the limit set by USERS parameter in the original LOCK 
command. 

47,LOCK/UNLOCK REQUIRES PASSWORD 

Returned if the proper password is not used with a LOCK or 
UNLOCK command on а lock with password set. 

48,MISSING VAL PARAMETER 

The WRITELOCK commmand requires а МАГ = «integer 
parameter to set the value of the lock. у 

BSAVE, BRUN, BLOAD (50-55) 

50,BRUN ATTEMPT TO WRONG ENVIRONMENT 

A BRUN command has been issued for a volume originally 
BSAVEd or CREATEd on a different type of computer (not 
allowed). 

51,NOT BINARY 

The pathname identifies a volume which is not binary (Т=В). 


Only binary volumes can be used for BSAVE, BLOAD, or BRUN 
commands. 


ERRORS 


53,FROM PARAMETER REQUIRED 


For BSAVE, the FROM parameter, which specifies the memory 
area from which data is to be taken, must be provided. For 
example, FROM - $1000. 


54,SIZE OR LENGTH PARAMETER REQUIRED 


For BSAVE, you must provide the SIZE or LENGTH parameter 
on the BSAVE command to indicate how much data is to be 
saved. This value must be less than or equal to the size of the 
volume specified on the original CREATE command. For exam- 
ple, SIZE =256.C. 


55,LENGTH/SIZE PARAMETER MISMATCH 

The number of characters represented by the LENGTH parame- 
ter is too large for the size of the file represented by the SIZE 
parameter. You must either decrease LENGTH ог increase 
SIZE. ў 

SET/LIST (56-58) 

57,FILE IS NOT A DIRECTORY 

The pathname given in a SET DIR command identifies a volume 
which is not a directory (Т= Y). 

58,USE: SET TIME [YYMMDD][, HH[MM]] 

If the date parameter was supplied, it was incomplete or con- 


tained invalid fields. If the time of day parameter was supplied, it 
contained invalid fields. 


ERRORS 


SHOW (59-80) 

59,TYPE - SYSTEM 

(Not an error.) The volume mounted on the drive for which you 
did a SHOW TYPE is a system volume (T — S). 

60,SHOW OPTION NOT RECOGNIZED 

The operand of a SHOW command was not recognized. Check 
the spelling and make sure there are no extraneous items in the 
command. 

61,DRIVE REQUIRED 

For the SHOW TYPE command you must specify the drive 
number on which the volume is mounted. For example, SHOW 
TYPE D12. 

62,NOT CURRENTLY MOUNTED 

The drive number specified has no volume mounted on it by the 
file server. 

63,TYPE - APPLE // CP/M 

(Not an error.) The volume mounted on the drive for which you 
did a SHOW TYPE is an Apple // CP/M volume (Т=С). 

64,NO DEFAULT DIRECTORY SET 

(Not necessarily an error.) This response to the SHOW DIR 


command indicates that there is no default directory established 
for this station by the file server. 


ERRORS 


65,TYPE - APPLE // PASCAL 

(Not an error.) The volume mounted on the drive for which you 
did a SHOW TYPE is an Apple // Pascal volume (T —P). 

66, TYPE - APPLE // DOS 

(Not an error.) The volume mounted on the drive for which you 
did a SHOW TYPE is an Apple // DOS volume (T- D). 
67,TYPE- BINARY 

(Not an error.) The volume mounted on the drive for which you 
did a SHOW ТУРЕ is a binary volume (Т=В). 
68,ТҮРЕ = DIRECTORY 

(Not an error.) The volume mounted on the drive for which you 
did a SHOW ТУРЕ is a directory (T=Y). 

69,UNKNOWN TYPE 

The volume mounted on the drive for which you did a SHOW 
TYPE is not a standard volume type. 

70,yymmddhhmmssw 

(Not an error.) Returns date and time information in encoded 
form. For example, the FS command TIMESTAMP returns the 
current year, month, day, hour, minute, second, and day of the 


week in the form 70,8604301859381 (that is, 6:59 p.m., Sunday, 
April 30, 1986). 
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71,--t--tt--t-t---- 


(Not an error.) Returns types of virtual disks currently mounted 
on drives 1-16 (Y,P,D,B,S,C,3,1,U,T). The system responds to . 
the FS command SHOW TYPES using this format. 


72,FS «$nn,SFS =$nn, T= <type>,<access>,<usage>, 
SIZE = «size > ,PS=<status>,PE=<primary ІОВ error code>, 
SS =<status>,SE=<secondary ІОВ error code> 


This is the response to the user inquiry "?«drive-" (in some 
environments); used primarily by programmers. $пп is the sta- 
tion address in hexadecimal of the current primary file server 
(FS) and the secondary file server (SFS). <type> is the type of 
volume currently mounted on drive d, with <access> and 
<usage> set. <size> is the size of the volume in blocks, 
given in the format nnnn.B. The <status> values .are the 
current usage status set for the drive for the primary and secon- 
dary file servers. 


Example: 


72,FS =$FE,T=|,RO,SHR,SIZE = 1000.B,PS=RW,PE=0, 
$$ =RO,SE=0 


Here, the current file server is $FE. The volume on the specified 
drive is of type |, mounted for Read/Only Shared usage. Size of 
the volume is 1000 512 byte blocks. Status of the primary file 
server is set to read/write from the primary and no error 
occurred on the last operation (PE=00). Status of the secon- 
dary file server is set to read/only and no error occurred on the 
last operation. 


73, TYPE- TEXT 


(Not an error.) The volume mounted on the drive for which you 
did the SHOW TYPE is a text volume (T - T). 
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74,TYPE - APPLE /// SOS 


(Not an error.) The volume mounted on the drive for which you 
did the SHOW TYPE is an Apple ., SOS volume (T=3). 


75,TYPE- IBM PC DOS 


(Not an error.) The volume mounted on the drive for which you 
did the SHOW ТУРЕ is an IBM PC DOS volume (Т =1). 


76, TYPE ІВМ PC P-SYSTEM 


(Not an error.) The volume mounted on the drive for which you 
did a SHOW TYPE is an IBM PC p-System volume (T - U). 


77, TYPE-REQUEST 


(Not an error.) The volume mounted on the drive for which you 
did a SHOW TYPE is a Nestar Request format volume (T =). 


78, ТУРЕ - USER DEFINED 


(Not an error.) The volume mounted on the drive for which you 
did a SHOW TYPE has no Nestar specified contents (Т = Х). 


79,FS CMD CHANNEL IS STN $nn 


Response to the user drive inquiry "20" (some environments). 
Gives current default file server for NET commands. 


80,DAY DD-MON-YYYY HH:MM:SS 


(Not an error.) This is the response to the SHOW TIME com- 
mand. 
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Local Messages (89-99) 
89, STATION NOT FOUND 


The station that the file server was set to (using the SET FS 
command) does not exist on the network (some environments). 


90,DRIVE IDENTIFIER(S) REQUIRED 


A drive number. or list of drive numbers, is required for this 
command. For example, SET DRIVES 4,5 VIRTUAL. 


91,DRIVE NUMBER NOT ALLOWED 


There are 12 drives (also called "volumes") in Pascal, but only 
some of them can be made virtual with the SET DRIVE local 
command. In Apple // Pascal Version 1.1, drives 3 through 12 
are valid. In Apple Pascal Version 1.2, drives 13 through 20 are 
also available. They follow the drive 3 settings. If drive 3 is set 
virtual to a file server, drives 13-20 will also be virtual to that file 
server. Do not set drive 3 real because the other drives can- 
not be made real, and such a setting will cause your file server 
to crash. 


92,NO DRIVE INFORMATION 


Response to the user drive inquiry "?L" (some environments) 
when no volume is mounted on the specified drive. 


93,DRIVE NOT VIRTUAL 


Response to the user drive inquiry "?L" (some environments) 
when the drive is real. 
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System Errors (94-99) 

94,FILE SERVER COMMAND NOT ISSUED 

This is a network error that indicates that the connection to 
another station has been terminated prematurely. 
95,UNRECOGNIZABLE NETWORK RESPONSE 

The last response message from the file server did not contain a 
numeric error code as expected. This may indicate incorrect 
logic in the use of NETUNIT procedures from within Pascal pro- 
grams. 

96,NO NETWORK CARD IN SLOT 

The slot number specified does not have a Nestar network inter- 
face card installed, or the card is defective (some environ- 
ments). | 

97, НЕЕ SERVER MEMORY FULL 

The file server has no space left for tables needed to complete 
your request. This does NOT refer to memory space in the user 
station. 

98,NETWORK TIMEOUT 

The network routines were unable to complete the transaction. 
The error may be transient; see the description of NETUNIT for 


more information. This error does not occur from most user level 
programs, such as NET. 
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99,USER ABORT 


The network abort key was pressed while a network transaction 
was queued up or in progress. The transaction was aborted. 


File System Errors (100-140) 

101,END OF FILE OR RECORD OUT OF RANGE 

An attempt was made to read a block or sector of a volume 
which is outside the legal range for that volume. 

102, VOLUME NOT FOUND 

The volume specified by the pathname was not found, or one of 
the directories in the pathname was not found. Check the spel- 
ling of each filename in the pathname. If the name does not 
begin with a slash, check that the current default directory is the 
correct one. 

103,BAD DELIMITER IN PATHNAME 

A delimiter other than "/" or ":" was found in a pathname. Make 
sure that you have not omitted a comma separating the path- 
name from other operands in the command. 

104,FILENAME OR PASSWORD TOO BIG 

A single filename (the part between slashes in a pathname) or a 


password (the part after a colon in a pathname) is longer than 
the maximum of 15 characters. 
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105,NO ACCESS FOR READ TO DIRECTORY 


You have been denied read access to a directory which is part 
of the specified pathname. 


106,NON DIRECTORY FOUND IN PATHNAME 


One of the names in the pathname (other than the last name) 
identifies a volume which is not a directory (T - Y). Only the last 
name in a pathname can be other than a directory. 


107,END OF PATHNAME IS A DIRECTORY 


The pathname specifies a directory (T - Y) in a context where a 
non-directory volume is required. 


108,CAN'T MOVE FROM ONE UNIT TO ANOTHER 


A MOVE command was attempted between pathnames on two 
different ^ units. For example, MOVE — .ALT/TEMP, 
-MAIN/USERS/XY,/TEMP. 


The new pathname must have the same unit name as the old 
pathname. 


109,ROOT DIR NOT SPECIFIED NO DEFAULT 


The specified pathname does not begin with a slash and there is 
no default directory recorded for this station by the file server. If 
you wish to completely specify the pathname. begin with a slash 
and the name or number of the disk unit. If you wish to use the 
current default directory, do not begin the pathname with a 
slash. You may use the SHOW DIR command to find out the 
current default directory and the SET DIR command to establish 
one. 
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110,NO ACCESS FOR READ 


You have been denied read access to the volume specified by 
the pathname, or to a directory along the path. 


111,NO ACCESS FOR WRITE 


You have been denied write access to the volume specified by 
the pathname. 


112,NO ACCESS FOR APPEND (not implemented) 


You have been denied append access to the volume specified 
by the pathname. 


113,NO ACCESS FOR ERASE 


You have been denied erase access to the volume specified by 
the pathname. Erase access is necessary to delete the file. 


114,NO ACCESS FOR CREATE 


You have been denied access to create or rename an entry in 
one of the directories specified in the pathname. 


115,NO ACCESS FOR DELETE 


You have been denied access to delete or rename an entry in 
one of the directories specified in the pathname. 
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116,CAN'T DELETE NON-EMPTY DIRECTORY 


The pathname specified in a DELETE command identifies a 
directory and that directory is not empty, i.e., it still points to 
other volumes. Only empty directories can be deleted by a sin- 
gle file server DELETE command. To delete non-empty direc- 
tories (i.e., subtrees) see the description of the TREEWALK util- 
ity in the user's manual for supported environments. 


117.FILE SERVER MEMORY FULL 


The file server has no space left for tables needed to complete 
your request. This does NOT refer to memory space in the user 
station. 


118,DISK FULL 


There is not enough contiguous space left on the disk unit to 
create the volume. The LIST command, when used to display 
the root directory, will give information about the space available 
on a disk unit. For example, LIST /MAIN. 


119,DIR OR VOL FULL - CAN'T BE EXTENDED 


Applies to directories and extendible volumes. The maximum 
number of entries for the directory has been reached or a 
volume has been extended to its maximum size. 


120,INTERNAL ERROR 


An internal error has been detected by the file server. Additional 
information is written on the console of the file server. That 
information and the circumstances surrounding the error should 
be transmitted to your support organization for diagnosis. The 
file server should be restarted as soon as practical. 
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121,UNINITIALIZED DISK 

The disk unit has not been initialized. All disks must be format- 
ted and initialized using the file server FORMAT DISK utility. 
122,WRONG SOFTWARE VERSION 

The disk format is not compatible with version of the file server 
currently running. Contact your support representative. 

123,FILE ALREADY EXISTS 

The file you asked to create or the new name used in a 
RENAME or MOVE command already exists in the directory. 
124,DISK ГО ERROR CODE X SUBCODE Y AT SECTOR Z 

A hardware ИО error was detected. The details of the error are 
described in the subcodes. 

125,VERIFY FAILED (BAD MEMORY) 

All disk write operations are verified by reading back the 
recorded data and comparing it to the data stored in memory. 
This error indicates that the disk data did not compare correctly. 
It sometimes indicates a memory error in the file server and not 
a disk error. 


128,BAD UNIT NUMBER IN PATHNAME 


The first item after the initial slash in a pathname is a number, 
but it is not in the legal range for unit numbers (1 to 4). 
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130,NEED PRIVATE PASSWORD FOR PROTECT 


In order to execute the PROTECT command for any volume, 
the private password must be specified in the pathname or as a 
default private password. The password must be specified 
whenever the volume has a non-null private password, regard- 
less of the access rights currently assigned to the volume. 


131,UNIT NAME NOT FOUND 

The name after the initial slash of a pathname is not the name 
of a disk unit currently recognized by the file server. You can 
also use the unit number in place of a name if you wish. 

132, CAN T LINK TO DIRECTORY 

An attempt was made to link to a directory (e.g., LINK 
;MAIN;PROGRAMS.;1, MAIN. USERS). Links can be made to 
any type of virtual volume except type Y. 

133,DISK NOT READY 

The disk unit specified is not ready. The one minute warmup 
period after initial power up may not have elapsed. It may also 
indicate a controller or disk drive failure. 

135,0UT OF FREESPACE DESCRIPTORS 

This message indicates that the unused space on the disk has 


become highly fragmented. Call your customer service 
representative. 
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Local Commands (200-250) 

200, RESPONSES DIFFERENT 

The response codes returned by the primary file server and the 
secondary file server are different. The two response lines that 
precede this error on the screen are those returned by the pri- 
mary file server and secondary file server. 

201,MISSING OR ILLEGAL READ/WRITE CODE 

The read,write code in the !а command is not of the correct for- 
mat. 

202,SFS=$NN 

The secondary file server for the command channel is station 
$nn. 

203, PRIMARY FS CANNOT ВЕ SAME AS SECONDARY FS 
An attempt was made to set the secondary file server to be the 
same as the primary. 

204,SECONDARY VOLUME IS NOT THE SAME AS PRIMARY 
An attempt was made to mount a volume on the secondary file 
server that is not identical to the volume on the primary file 
server. The volumes must have identical type, size, usage, and 
directory entries. 


210,005 1/0 ERROR 


A DOS error occurred while INITing a volume. Retry the INIT 
command. 
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211,ENTRIES INVALID WITH SYS OPTION 
When initializing an IBM PC DOS bootable virtual volume, the 


ENTRIES parameter cannot be used when the SYS option is 
specified. 
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The Apple / DOS User Environment 


B.1 Transferring Additional Necessary Files to 
/MAIN/LIB/APPLE2/DOS 


To make commonly used programs such as FID ог MUFFIN 

available to all network DOS users on a shared library volume, 

obtain an Apple DOS diskette containing, for example, FID and 

MUFFIN. With a local floppy connected via slot 4, power on an 

Apple // workstation that has been attached to the network in 

response to the "Volume to Boot" prompt, type 
;MAIN.LIB/APPLE2/DOS 


Туре "PR#N" (where "М" is the slot containing the Network 
Interface Card). 


Insert the Apple diskette and type: 
LOAD FID, S4, D1 


SAVE FID, SN, D1 
(N = Network Interface Card slot) 


LOAD MUFFIN, S4, D1 


SAVE MUFFIN, SN, D1 


B.2 Setting Up Disks for the DOS Environment 


From a user station, boot /MAIN/LIB/APPLE2/DOS. After the 
prompt has been displayed, type "RUN CREATE". Respond to 
the program's prompts. The CREATE program is documented in 
the Apple /’ DOS User's Guide. 
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The Apple // Pascal User Environment 


C.1 Transferring Additional Necessary Files to 
/MAIN/LIB/APPLE2/UCSD/PASCAL 


The BOOT program MOUNTS one of the virtual library volumes 


/MAIN/LIB/APPLE2/UCSD/PASCAL40 
/MAIN/LIB/APPLE2/UCSD/PASCAL80 
/MAIN/LIB/APPLE2E/UCSD/PASCAL40 
/MAIN/LIB/APPLE2E/UCSD/PASCAL80 


on drive #5 as a library for Pascal users. (This may be 
changed by changing the contents of the profile record for a par- 
ticular user station address.) 


SYSTEM.COMPILER, SYSTEM.EDITOR, etc., which may be 
needed, are licensed through Apple Computer, Inc. and must be 
purchased through them. These system files are not included in 
the virtual library volumes shipped by Nestar. 


To copy the Pascal system files to the library volumes, follow 
the procedure listed here. 


Note: The four library volumes are protected from write opera- 
tions with the password "NESTAR". The password or protection 
may be changed using the PROTECT command from the sys- 
tem console or from the NET program at a user station. The 
current password must be given in the PROTECT command. 


(1) Start the network file server (flip on power switch). 


(2) Configure a user station with a network interface card in 
slot 6, and a 16-sector Apple floppy drive in slot 5, drive 1. 
Ensure that all minidisks are for use with Apple Pascal 
Release 1.2. 


APPLE // PASCAL 


(3) 


(4) 


(5) 


(6) 
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Boot one of the four library volumes at the user station by 
turning on the power and answering the prompt: 


VOLUME TO BOOT: 


with /MAIN/LIB‘APPLE2/UCSD/PASCAL40:NESTAR or опе 
of the other three library volumes. At this time you must 
choose which is the appropriate library to boot for a partic- 
ular user station, depending upon whether the station is 
an Apple ;; with 40 column display, Apple // with 80 column 
display, Apple ‚/е with 40 column display, or Apple //e with 
80 column display. 


Insert APPLE1:, the Pascal Release 1.2 system floppy 
diskette provided by Apple, into the local mini disk drive. 


Enter the Pascal Filer (on APPLE1:) by typing "F". 


The BOOT program will mount the specified library volume 
on both #4: and #5:. In the Filer this will cause the mes- 
sage "WARNING UNITS 4 & 5 HAVE THE SAME NAME" 
to appear. Disregard this warning and execute the following 
steps exactly. 


Transfer the Apple Pascal files from APPLE1: and APPLE2: 
to #4. 


From APPLE1: 


SYSTEM.EDITOR 
SYSTEM.LIBRARY 
SYSTEM.CHARSET 
SYSTEM.SYNTAX 
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From APPLE2: 


SYSTEM.COMPILER 
SYSTEM.LINKER 
SYSTEM.ASSMBLER 
6500.OPCODES 
6500.ERRORS 


Repeat steps 3 through 7 for each type of user station to be 
used on your network (i.e., Apple // with 40 column display, 


Apple // with 80 column display, Apple //e with 40 column 
display, Apple //e with 80 column display). 


APPLE1: and APPLE2: are diskettes distributed by Apple with 
the Pascal system. Be sure to use Release 1.2 of Apple Pascal. 
If you have an older release of Apple Pascal, see your Apple 
dealer for an updated release. 


Note: Only transfer the files listed above. DO NOT TRANSFER 
SYSTEM.APPLE, SYSTEM.PASCAL, or SYSTEM.MISCINFO. 


File transfer is done as follows: 


(1) 


The file to be transferred is on a 5 1/4" floppy diskette. 
Insert it in drive 1 of the controller in slot 5. 


Type "T" for transfer 
The filer will respond with: 


TRANSFER WHAT FILE ? 


Type in the volume name followed by the file name (e.g., 
APPLE1:SYSTEM.EDITOR). Then type «Return». 


The filer will ask: 


TO WHERE ? 


APPLE // PASCAL 


Type "#4:$". 


Do this for each file to be transferred. 
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Setting Up User Virtual Volumes for the Pascal 
Environment 


Use the steps below to create Pascal volumes for users. 


(1) 


(3) 


Boot MAIN/LIB/APPLE2/UCSD/PASCAL at a user station 
by turning on the power and answering the prompt: 


VOLUME TO BOOT: 
with 
/MAIN/LIB/APPLE2/UCSD/PASCAL,RO 


The "RO" gives you read-only access to the library. This will 
prevent any accidental changes to the library. 


From the command level of Pascal X(ecute Net by typing 
"X". The system will respond: 


EXECUTE WHAT FILE? 


Туре "NET" and press «Return». 


NET will display its copyright notice followed by the prompt 
. Create the user's bootable Pascal volume (for 
instance, MAIN;/USERS/NAME/1) and mount it on drive 9 


by typing: 
CREATE /MAIN/USERS/NAME/1,T=P,D9,RW 


If there is a minidisk controller in slot 4, set drive 9 virtual 
by typing 


SET DRIVE 9 VIRTUAL 
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(4) Type О < Return. to exit NET. 
(5) Go into the Pascal Filer by typing "F". 


(6) Zero MAIN'USERS/NAME:/1's directory by typing "Z". The 
filer will respond 


ZERO DIR OF WHAT VOL ? 
Respond with "#9:". The filer will ask: 
DUPLICATE DIR ? 


Since Apple Pascal does not support this feature, type "№". 
Next, it will ask: 


# OF BLOCKS ON THE DISK ? 
Enter whatever number you used for SIZE-x when you 
created MAIN/USERS/NAME/1 (280 blocks in this example, 
since SIZE= was not specified in the CREATE command). 
Then it will ask: 

NEW VOL NAME ? 


We suggest you name the volume "МАМЕ:". Туре "МАМЕ" 
and «Return». It will ask if this is correct by: 


NAME: CORRECT ? 
Type "Y". The zero command terminates with the message 


NAME: ZEROED. 


The user can now boot a user station in Pascal by responding to 
the BOOT program with: 


/MAIN/USERS/NAME. 1 
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Note that the instructions for what pathnames to use 
(/MAIN/USERS/NAME/1) and what Pascal volume names to 
use (NAME) are only suggestions; other naming conventions 
may be preferred in some envirónments. 
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Appendix D 


The Apple // CP/M User Environment 


0.1 Transferring Additional Necessary Files To 
/MAIN/LIB/APPLE2'CPM 


A number of files necessary or useful in the CP/M environment 
with the file server software can be found on the shared library 
volume /MAIN/LIB/APPLE2/CPM: 


CMDUNIT.FNS NWLIB.ERL 
CMDUNIT.TYP NWRTNS.REL 
COPYSYS.COM OFF.COM 
CREATE.COM REALFMT.COM 
INSTALL.SUB SETREAL.COM 
NCONFIG.BAS SETVIRT.COM 
NET.CMD STARTCMD.SUB 
NETUNIT.FNS SUBMIT.COM 
NETUNIT.TYP . TURNKEY.COM 


Users may want additional files on the library volume (such as 
PIP, STAT, and the other programs found on the Microsoft dis- 
tributed diskette). 


Before adding such program files, note that two cards are 
needed in the 64K user Apple: 


a Z-80 card in any available slot 
a minifloppy controller in slot 4, drive 1 


With these cards installed, power on a user station and respond 
to the "Volume to Boot" prompt with 


;MAIN/LIB/APPLE2/CPM 


When the A> prompt appears, insert the Microsoft 16 sector 
CP/M diskette in the floppy drive. Then type 


SUBMIT INSTALL 


D-1 


APPLE .' CP'M 


This program will automatically PIP files from the Microsoft 
diskette to your library volume. Not all the files on the Microsoft 
diskette are transferred. DO NOT transfer any others. 


D.2 Setting Up User Virtual Volumes for the CP/M 
Environment 


To set up bootable virtual volumes for CP;M users, power on а 
user station and respond to the "Volume to Boot" prompt with 


/MAIN/LIB/APPLE2/CPM 
Follow the CREATE.COM instructions in the user guide for this 


environment. CREATE.COM mounts the new volume on G:. 
PIP necessary files such as NET.COM from A: to G:. 
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The Apple /// SOS User Environment 


E.1 Transferring Additional Necessary Files to 


/MAIN/LIB/APPLE3'SOS 


Nestar distributes the following Apple /// SOS environment files 
оп the shared library volume /MAIN/LIB/APPLE3/SOS: 


To 


CAPTURE (Business Basic) 
NESTAR.START 

NET (Business Basic) 
NET.CODE (Pascal) 
NETHELP.TEXT 
NETWORK.LIBRARY 
SYSTEM.FILER i 
TCOPY.CODE 
TREEWALK.CODE 

UTILS (APPLE /// Utility Filer) 


install additional necessary or useful files such as 


SYSTEM.EDITOR: 


(1) 
(2) 
(3) 
(4) 


(5) 


(6) 


Boot the Nestar supplied Apple /// Pascal boot diskette. 
X(ecute) NET. 

Mount /MAIN/LIB/APPLE3/SOS,D1,RW. 

Q(uit) the NET program. 


Insert the Apple /// PASCAL1 diskette in the Apple's built-in 
floppy. 


Туре "Е" to use the filer. 
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(7) 


(8) 


E.2 


Transfer the real diskette files to the shared library volume 
by typing "T" and answering the prompt "Transfer what 
file?" with 


.D1/XX,.N1/$ 


where "XX" is the filename. 


Repeat this procedure using the Apple ///, PASCAL2, and 
PASCAL3 diskettes, as well as any other SOS diskettes 
containing useful Pascal or Business Basic programs. 


Setting Up User Virtual Volumes for the Apple /// 
Environment 


Before continuing, read Section 2.3 of the File Server Apple . 
SOS User's Guide. 


To create non-bootable virtual volumes for system users: 


(1) 


(2) 


(3) 


(5) 


Boot а user station with an Apple /// Pascal diskette config- 
ured for network use. 


Mount ‘MAIN/LIB APPLES/SOS if it has not been mounted 
automatically. 


Note: If the boot diskette being used is a copy of the mas- 
ter Apple .// Pascal network boot diskette shipped with your 


network, the shared library volume is mounted during the 
boot process. 


X(ecute) /LIB/NET. 
Create /.MAIN/USERS/NAME/SOS1,T -3,D2, RW. 


Quit the NET program. 


APPLE /// SOS 


(6) Use the /LIB UTILS program to format the new volume, 
now mounted on .N2 for READ/WRITE usage. This volume 
has a size of 280 blocks, the default value, since the size 
parameter was not specified in the create command. 


E.3 Creating Boot Diskettes 


The system is shipped with two Apple ` boot diskettes that 
have been configured for network use. SOS.DRIVER files con- 
tain the necessary network driver code to handle several char- 
acter devices (.NCMD, .NMSG and .PRINTER) and 11 block 
structured devices (.N1 - .N11). 


One diskette contains a Business Basic interpreter (Master 
Basic network boot diskette); the other contains a Pascal inter- 
preter (Master Pascal network boot diskette). 


The system manager should make a working copy of each 
diskette and then place the original master diskette in a secure 
place. (Use те Utility Filer that is shipped as 
SYSTEM.STARTUP on the SYSTEMS UTILITY diskette from 
Apple to duplicate the diskette.) 


In addition to backing up the master diskettes, the system 
manager needs to make a copy for each user. (Some users 
may not need both Pascal and Business Basic network boot 
diskettes.) 


The Apple /// driver defaults to the file server with station 
number 254 ($FE in hexadecimal). At boot time the driver 
sends a request for the current time to the default file server. If 
your installation does not have a file server at address $FE, you 
must modify the default with the System Configuration Program 
in the SOS utility menu. You must also make this modification 
when volumes are to be pre-mounted on file servers other than 
$FE. 


To modify the default file server, boot the boot diskette. If the 


shared library volume is not automatically mounted (via the 
STARTCMD file), use the NET program to mount it. X(ecute 
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/LIB/UTILS. Select S. for System Configuration Program. R(ead 
into memory the file .d1 SOS.DRIVER. 


Select option E (edit driver parameters). 


Select the .NCMD device if you wish to change the default file 
server. 


Otherwise, select the network device that will have volumes 
premounted on file servers other than $FE. 


Select option 6 (Edit Configuration Block Data). The program 
will display a number of bytes and a cursor surrounding byte O. 
Move the cursor to byte 4 using the arrow keys. Byte 4 should 
contain "FE". Enter the station ID of the new default or pre- 
mount file server in hexadecimal and press «Return». Press 
<Esc> twice to return to the Edit Driver Parameters menu. 


Repeat the operation for each device that needs to be modified. 
When formatted, press <Esc> to return to the main SCP menu. 
Press G (Generate New System) and write the new system to 
.d1/SOS.DRIVER. 
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The IBM PC p-System User Environment 


F.1 Transferring Additional Necessary Files to 
/MAIN/LIB/IBMPC/P-SYSTEM 


/MAIN/LIB/IBMPC/P-SYSTEM is the virtual volume that can be 
used as а library for p-System users. Аз shipped, 
/MAIN/LIB/IBMPC/P-SYSTEM does not contain 
SYSTEM.COMPILER or SYSTEM.EDITOR which may be 
needed to use the p-System environment. 


To copy these Pascal system files to /MAIN/LIB/IBMPC;P- 
SYSTEM follow the procedure listed here. 


Note: /MAIN/LIB/IBMPC/P-SYSTEM is protected from write 
operations with the password "NESTAR". The password or pro- 
tection may be changed using the PROTECT command from 
the system console or from the NET program at a user station. 
The current password must be given in the PROTECT com- 
mand. 


(1) Boot a network boot diskette or network virtual volume (see 
Section F.3 for instructions on creating network boot 
diskettes and Section F.2 for instructions on creating boot- 
able network virtual volumes). 


(2) X(ecute NET and enter 
MOUNT /MAIN/LIB/IBMPC/P-SYSTEM:NESTAR,D12, RW 
SHOW DRIVES 


Note which drive(s) are REAL. Your computer will access 
floppy disks on these drives. 


Type "Q" to quit NET. 
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(3) Use the Filer te t'ansfer SYSTEM.COMPILER апа 
SYSTEM.EDITOR from a floppy disk (in #4 if drive 4 is 
REAL. in #9 if drive 9 is REAL) to #12. 


F.2 Setting Up User Virtual Volumes for the Pascal 
Environment 


Use the steps listed below to create Pascal volumes for users. 


(1) Boot a network boot diskette or network virtual volume (see 
Section F.3 for instructions on creating network boot 
diskettes, and Section F.2 for instructions on creating boot 
able network virtual diskettes). 


(2) From the command level of the p-System, X(ecute NET by 
typing "X". The system will respond: 


EXECUTE WHAT FILE? 


Type "NET" and press «Return». 


(3) NET will display its copyright notice followed by its prompt 
"i". Create the user's bootable p-System volume (for 
instance, ;/MAIN/USERS/NAME/1) and mount it on drive 12 
by typing: 


CREATE /MAIN/USERS/NAME/1,T=U,D12,RW 
(4) Type О «Return» to exit (quit) NET. 
(5) Go into the p-System Filer by typing "F". 


(6) Zero /MAIN/USERS/NAME/1's directory by typing "2". The 
filer will respond: 


ZERO DIR OF WHAT VOL ? 
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Respond with "#12:” The filer will ask: 
DUPLICATE DIR ’ 

Туре "М". Меж, it will ask: 
# OF BLOCKS ON THE DISK ? 


Enter whatever number you used for SIZE =х when you 
created MAIN/USERS.NAME/1. In this example, since 
SIZE= was not specified in the CREATE command, the 
default size (640 blocks) was used. Then the zero com- 
mand will ask: 


NEW VOL NAME ? 


We suggest you name the volume "NAME." (replace 
"NAME" in this example with the user's name or initials). 
Туре "NAME" and <Return>. It will ask if this is correct 


NAME: CORRECT ? 


Type "Y". The ZERO command terminates with the mes- 
sage 


NAME: ZEROED 


№ the volume is to be bootable, transfer block O to it (the 
boot track for p-System). 


If, for example, your bootable volume is the real floppy in 
drive 4 and the newly created volume is on drive 12, first 
enter the Filer by typing "F" from the "Command:" prompt 
line. Type "T" (for transfer). The response will be "Transfer 
What File?". Respond with #4: (the bootable volume), fol- 
lowed by a «Return». 


The response will be "To Where?", to which you respond 
"3:12:". You will then be asked "Transfer 640 blocks? (Y/N)" 
(when 640 is the number of blocks on the volume), to which 
you respond "№". You will then be asked "# of blocks to 
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transfer?" to which you respond "1". 


(8) If the volume is to be bootable, copy over 
SYSTEM.PASCAL 
the network's patched 
SYSTEM.INTERP 
and 


SYSTEM.MISCINFO 
SYSTEM.LIBRARY 
NETWORK.LIB 

USERLIB.TEXT 

NET.CODE or SYSTEM.STARTUP 


F.3 Creating Boot Diskette Requirements 


Note: NCI licenses p-System for use on one IBM PC. According 
to the terms of the license, you must obtain one copy of p- 
System for every machine on the network to run p-System or 
application programs that run under p-System. 


You will need an IBM PC with two or more double sided diskette 
drives. 


One p-System BOOT diskette is shipped with the system. 


Further boot diskettes can be produced by simply copying the 
entire volume BOOT:, including the boot block (block 0), onto a 
formatted diskette using the Filer T(ransfer command and 
responding to "Transfer what file?" with "Boot:,#5:". Then use 
the Filer C(hange command to change the name of the new 
boot diskette. 


The file SYSTEM.INTERP on the boot diskette and on the 


° library volume have been patched by Nestar to access the net- 
work and to support 6 drives (rather than 4). DO NOT use the 
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standard. unpatct:ed ІВМ version of this file. 


Program Application E Memory Requirement 
SYSTEM STAR™ JP 64K 
NET.CODE 64K 
PRINT CODE 64K 
TCOPY.CODE 64K 
MAIL.CODE 128K 
PRINT SERVER 128K 
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The IBM PC DOS User Environment 


G.1 Transferring Additional Necessary Files to 
/MAIN/LIB/IBMPC/DOS 


A number of files necessary or useful in the DOS environment 
with the file server software are included on the shared library 
volume /MAIN/LIB/IBMPC/DOS, including: 


ANSI.SYS FSCMDPAS.PAS NSR.ASM 
ART.BAS GRAFTABL.COM NSRC.H 
ASSIGN.COM GRAPHICS.COM NSRUNIT.ITF 
ATTRIB.EXE IBMIO.COM NU AUTO.TXT 
AUTOEXEC.BAT IBMDOS.COM NU_PRO1.TXT 
AUTOTEMP.BAT KEYBFR.COM NU_PRO2.TXT 
BACKUP.COM KEYBGR.COM NU_VPRN.HDR 
BALL.BAS KEYBIT.COM NWCMDS.COM . 
BASIC.COM KEYBSP.COM PIECHART.BAS 
BASICA.COM KEYBUK.COM PRINT.COM 
CARDCHK.EXE LABEL.COM PRINTQ.EXE 
CHKDSK.COM LINK.EXE PROFILE.COM 
CIRCLE.BAS LAASM.ITF RECOVER.COM 
CMDUNIT.ITF LALOC.ASM RESTORE.COM 
COLORBAR.BAS  MAKEBOOT.BAT SAMPLES.BAS 
COMM.BAS MAKESAMP.BAT SELECT.COM 
COMMAND.COM MENU.BAT SETPRINT.EXE 
COMP.COM MODE.COM SHARE.EXE 
CONFIG.SYS MORE.COM SORT.EXE 
CONTEMP.SYS MORTGAGE.BAS SPACE.BAS 
COUNT.EXE MUSIC.BAS STARTCMD 
DEBUG.COM MUSICA.BAS STARTUP.EXE 
DISKCOPY.COM NEST.COM SYS.COM 
DISKCOMP.COM МЕТ.ЕХЕ TCOPY.EXE 
DONKEY.BAS NETBAS.LIB TEMPAUTO 
EDLIN.COM NETBAS.LST TNSRBAS.BAS 
EXE2BIN.EXE NETC.LIB TNSRBAS.EXE 
FDISK.COM NETC.LST TNSRC.C 
FIND.EXE NETCOB.LIB TNSRC.EXE 
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FORMAT COM NETCOB.LST TNSRCOB.COB 
FSCMDBAS.BAS  NETCONFG.EXE TNSRCOB.EXE 
FSCMDBAS EXE —. NETPAS.LIB TNSRPAS.EXE 
FSCMDC C NETPAS.LST TNSRPAS.PAS 
FSCMDC.E XE NETTEMP.SYS | TREE.COM 
FSCMDCOB.COB  NETUNIT.ITF VDISK.COM 
FSCMDCOB.EXE NETWORK.SYS  VDISK.LST 
FSCMDPAS.EXE NEWUSER.EXE 


Other useful volumes (e.g., support for compilers and assem- 
blers) on /MAIN/LIB/IBMPC/DOS can be found in the following 
subdirectories: 


MASM 
PASCAL 
BASIC 
COBOL 
MSOFT 


Users may want additional files on the library volume (such as 
FORMAT and the other programs found on the IBM distributed 
diskette). 

This can be done by using the NET program to mount the library 


volume with RW access and than using the DOS COPY com- 
mand to copy any desired files to the library volume. 


G.2 Setting Up User Virtual Volumes for the DOS 
Environment 


See Section G.3 for instructions on creating network-bootable 
diskettes. 


Method 1 


На new user is enrolled using this method: 


(1) When the new user powers on the specified workstation, 
he/she will boot from the shared DOS library volume оп С:. 


G-2 


IBM PC DOS 


(2) His he: per ‘па: non-bootable work volume (which is 
created using this method) will be mounted on E:. 


From the Nestar Main Menu, at an IBM PC workstation, select 
the "System Management" option. Provide the password. 


From the System Management menu, select the "new user" 
option. Prompts will assist you in creating: 


(1) A non-bootable work volume for the new user. 


(2) A profile that will cause the station at power on to boot from 
the shared DOS library volume on C: and mount the work 
volume Read/Write on E: (see section 1.2.1 of the DOS PC 
DOS Reference Manual for details on the prompts) 


Method 2 


To set up virtual volumes for DOS users "by hand" according to 
your own size specifications, boot a network boot volume. 


Follow the instructions for the INIT command of the NET pro- 
gram in the Network Command Reference Manual or the refer- 
ence manual for this environment. 


Warning: The DOS command ASSIGN should not be used with 
the network. The ASSIGN command works only in systems 
employing eight drives or less. If your system employs more 
than eight drives, using the ASSIGN command can destroy data 
on your volumes. 


G.3 Creating Boot Diskettes 


Real Diskettes 
Note: IBM licenses DOS for use on one IBM PC. According to 


the terms of the license, you must obtain one copy of DOS for 
every machine on the network to run DOS or the application 
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programs that run under DOS 


Real boot diskettes can be made by having a boot volume (real 
or virtual) on drive A', inserting a blank diskette into B:, format- 
ting the blank diskette and copying all files from A: to B:, as fol- 
lows: 


a: 
format b:/s 
copy *.* b: 


The diskette in B: will be a network boot diskette with all utilities 
available that were available on the "old" boot diskette. 


Note: An automatic procedure to accomplish the steps above is 
provided as MAKEBOOT.BAT on the distributed utility volume 
//LIB/IBMPC/DOS. 


Virtual Diskettes 


The library volume //LIB/IBMPC/DOS is a bootable volume as 
shipped with your system. Being much larger than a floppy disk, 
this volume is slower to boot than a smaller disk because its 
FAT and directory are larger, both of which must be brought into 
the memory of your IBM PC during boot. Also, the volume must 
be booted mounted on drive C: which may or may not be the 
most convenient way to boot. Therefore, you may want to make 
a bootable virtual volume smaller than the library volume. 


To create a virtual bootable volume, first boot the library volume 
//LIB/IBMPC/DOS. Then, run the NET program. Use the INIT 
command to create and initialize your virtual volume. To boot on 
А: or С:, the SIZE that you specify in the INIT command should 
be left blank which will create a 720 sector volume, or specify 
320, 360, 640 or 720 sectors. Any of these volume sizes is 
appropriate for a small floppy-sized volume. 


To boot only from C:, specify any size. 


In addition, specify the SYS option on the INIT command. The 
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SYS option will make the virtual volume bootable. At the suc- 
cessful conclusion of the INIT command, the new volume will be 
bootable. 


Additional files that can be put onto the volume to govern the 
booting process are documented in Chapter 9 of the /BM PC 
DOS Reference Manual. 


In order to use virtual volumes other than the volume that you 
boot from, you need to use the CONFIG.SYS and 
NETWORK.SYS files. In order to automatically execute a pro- 
gram when the booting process completes, you need the 
AUTOEXEC.BAT file. These files can be copied from the library 
volume after the INIT command completes. 


G.3.1 NEWUSER Utility 


NEWUSER is an IBM PC DOS program that provides the sys- 
tem manager with a utility for adding a new PC DOS user to the 
network. The program is described for the workstation user in 
the PLAN Series IBM Personal Computer DOS Reference 
Manual. 


The program prompts for the drive containing four "template" 
files, described below. The program then goes into a loop, 
prompting for the new user's home file server station number, 
the private password for //users on that file server (if t is pass- 
word protected), the user's workstation number, the new user's 
ID, the new user's optional private password, and the size of the 
new user's volume in blocks. Using that input plus the four tem- 
plate files, NEWUSER then creates a workstation profile, a user 
profile, and an IBM PC DOS volume for the user. 


If a password has been specified for the new user, it becomes 
the private password for the user profile and the user's volume 
and no public or group access is granted. The user's volume will 
contain an AUTOEXEC.BAT file and a file of virtual printer 
parameters. 


Once a user has been added to the network, the system 
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manager can choose to either exit the utility or add another user 
using the same template files. To create new users using dif- 
ferent template files, the system manager must exit NEWUSER 
(and rename the template files if necessary), then re-run 
NEWUSER, specifying the appropriate default drive. 


Warning: Do not terminate NEWUSER by rebooting the works- 
tation. Doing so may leave temporary volumes on the network 
and/or may cause a new user to be not completely added to the 
network. 


If a network error causes termination of NEWUSER while a new 
user is being added, the system manager should eliminate the 
cause of the error, delete any profiles or volumes that may have 
been created (for the user that was being added when the prob- 
lem occurred), then re-run NEWUSER and attempt to add that 
user again. 


Do not mount any volumes while running NEWUSER This may 
result in the abnormal termination of the NEWUSER utility. 
NEWUSER searches from drives Z: to A: for an available virtual 
drive on which to create T- T and Т=| volumes. This drive is 
unmounted before the utility terminates. 


Since NEWUSER does not check the validity of the four tem- 
plate files, it may be advisable to add a single user initially, ver- 
ify that the templates are correct, then re-run NEWUSER to add 
the remaining users. 


Because this first release of NEWUSER does not support multi- 
ple file server networks, it is possible to add two different users 
on the same station number if they are added to two different 
home file servers. Similarly, it is possible to add the same user 
to two different station numbers if they are added to two dif- 
ferent home file servers. In the case of a single file server net- 
work, this is not a problem. However, the query "Enter Home 
FS Station Number:" is not meaningful. 
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Data 


NEWUSER assumes that the following four IBM PC DOS files 
exist on the drive specified at the onset of the program, and 
checks the specified drive for these files upon startup before 
going on to prompt for the other input parameters. NEWUSER 
makes text string replacements in the output files. 


nu proí.txt is the text file which serves as the template for 
creating the workstation profile volume. This menu should, at 
the minimum, allow the user to either proceed to the user menu 
(if the user password is known) or to enter profile commands 
from the keyboard. 


nu pro2.txt is the text file which serves as the template for 
creating the user profile volume 


nu auto.txt is the text file which serves as the template for the 
AUTOEXEC.BAT file which will be created on the user's 
volume. 


nu vprn.hdr is the file of escape sequences (such as output 
from SETPRINT) which serves as the template for the file of vir- 
tual printer parameters which will be created on the user's work 
volume. 


Default template files are shipped on the library volume. If any 
of these four template files are not found on the drive specified 
by the system manager, NEWUSER issues a message naming 
the missing file, then prompts the system manager to specify an 
alternate drive. 

Configuring the Template Files 

The system manager may want to alter the template files before 


executing NEWUSER. NEWUSER makes text string replace- 
ments as described below. 


(1) User's Home File Server Number 


Any occurrences of the strings "%f" ог "%F" in a template 
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(2) 


(3) 


file will be replaced in the corresponding output file or pro- 
file with a string consisting of a "$" followed by the two-digit 
hexadecimal representation of the user's home file server 
station number. 


User's Workstation Number 


Any occurrences of the strings "м" or "%W" in a template 
file will be replaced in the corresponding output file or pro- 
file with a string consisting of a "$" followed by the two-digit 
hexadecimal representation of the users workstation 
number. 


User's ID 


Any occurrences of the strings "%u" or "%U" in a template 
file will be replaced in the corresponding output file or pro- 
file with the user's ID in uppercase characters. 


Default Template Files 


The following are listings of the default template files shipped on 
the PC DOS library volume. The system manager may wish to 
change: the files before running NEWUSER. The strings "%f", 
"Jow", and "и" in the input files will be replaced in the 
corresponding output files by the strings representing the user's 
home file server station number, the user's workstation number, 
and the user's ID, respectively. 


(1) 
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Default Template File for the Station Profile 


The following is the default template file nu prot.txt. The 
corresponding output is the station profile on the user's 
home file server. 


unmount all 

MENU delay 5 

>> Сћһаіп to %u’s Profile 
@$% 


IBM PC DOS 


profile %u 

>Chain to a Different Profile 
profile 

ENDMENU 


(2) Default Template File for the User Profile 


The following is the default template file nu_pro2.txt. The 
corresponding output is the user's profile on the user's 
home file server. 


MENU delay 5 


%и’5 Profile 
Station $%w 
FileServer $%f 


> Boot DOS 3.0 with %u’s Volumes on Drive e: 
$fe mount //lib/ibmpc;dos,c: 

@$%f mount : users/?eu/pcdos,e:,rw,exc 

boot c: 

echo boot c. 

Show the Time and Date 

show time 

pause 

ENDMENU 


(3) Default Template File for AUTOEXEC.BAT 


The following is the template file nu. auto.txt as distributed 
on the PC DOS library volume. The corresponding output 
file will be autoexec.bat on the user's work volume. 


echo off 

path c: 

n set dir //иѕегѕ/%и 
copy vprn.hdr Ipt3 


(4) Default Template File for the Virtual Printer Parameters 
VPRN.HDR 
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The following is the template file nu vprn.hdr where 
"<Esc>" represents the ASCII escape character. Тһе 
corresponding output file will be vprn.hdr on the user's work 
volume. 


«Esc»v.n«Esc -vtegtype:print 
« Esc» vspooled:data 
«Esc» vstation:9ow 
<Esc>vid:%u 
<Esc>vname:%u 
<Esc>vserver:any 

« Esc» vprinter:any 
«Esc» vsetup:standard 
« Esc vpriority:standard 
«Esc» vtitleline:no 
<Esc>v.s 


G.4 Installing DOS 2.10 on the Network 


Installing DOS 2.10 on the network requires the following equip- 
ment: 


— an IBM PC or an IBM PC XT with 128k of memory 
— 1 floppy disk (A:) 
— DOS 2.10 boot diskette 


Once the equipment is assembled, use the following procedure: 


(1) 


Reboot the computer (either with <Ctrl> «Alt» «Del or 
by turning the computer off and on), and start with the Nes- 
tar Main Menu. 


Select "Other Boot Options". 
Select "Boot PC DOS". 


Select the option that boots into DOS 3.00. 


ВМ PC DOS 


(5) Insert the DOS 2.10 boot diskette into drive A. 
(6) Type "A:". 
(7) Туре "С NET". The prompt (" : ") will appear. 


(8) Type “INIT LIB IBMPC/DOS2.0,F:,SIZE =2200.B,SYS, 
VOLNAME = DOS2.1 LIB . 


(9) Type "QUIT". The "A>" prompt will appear. 
(10) Type "COPY C: *.* F:". 


(11) Type "COPY A: COMMAND.COM F:". 


G.5 Changing PLANPak to use DOS 2.10 instead of 
DOS 3.10 


If DOS 2.10 is present on a //LIB/IBMPC/DOS 2.0 library 
volume 


To change PLANPak to use DOS 2.10 instead of DOS 3.10, use 
the following procedure: 


(1) Rename 
//SYSTEM/PROFILE‘MENU 
as 
//SYSTEM/PROFILE/MENU.BAK. 
(2) Use the TCOPY utility to copy the profile 
//SYSTEM/PROFILE/MENU.BAK 


to a local file. 


IBM PC DOS 


(3) Edit the local file using a text editor (such as EDLIN), and 
modify the two mounts of ;/LIB/IBMPC/DOS to two mounts 
of //LIB.IBMPC:/DOS?2 0. 


(4) Use the TCOPY utility to copy the updated file to the 
volume //SYSTEM/PROFILE/MENU. 


If DOS 2.10 is not present on the file server: 
Required materials: 


- IBM PC with at least one floppy drive, on the network 
- DOS 3.10 network volume 
- DOS 2.1 floppy disk 


Insert your DOS 2.1 floppy in drive A:. 


Boot DOS 3.10 from the network from the main menu 
(press Function Keys F6, F3, F1 when prompted). 


When this is done, enter the following commands: 


С>А: 

А>С:МЕТ 

:UNMOUNT C: 

:INIT /MAIN/LIB/IBMPC/DOS2.1,SYS,SIZE =4601.S,RW,D: 
:Q 

A>COPY *.* D: 

A>COPY L:CONFIG.SYS D: 

A>COPY L:NETWORK.SYS D: 

A>COPY L:NET.EXE D: 

A>COPY L:TCOPY.EXE D: 


Create a menu entry for DOS 2.1 (mounting the DOS 2.1 library 
volume), or use network commands to mount and boot it. Menu 
entries are explained in Chapter 1 of the PLAN Series IBM PC 
Dos Reference Manual. To boot DOS2.1, press <ctri> <alt> 
<del> and select the new menu entry. 
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‚ Decimal/Hexadecimal/Binary Conversion 
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